2026-03-09

Pools + Project

Versions:

Peter: Implicit is where system auto created pool based on top of normal/bottom of, can also create your own pools. Implicit false. Assign any level to.
'pool-name' in the pools getALL endpoint is the equivalent of 'pool-id'
Not sure what the wildcards offer in the getOne endpoint of /pools/{pool-id} vs the getAll you can do more filtering
Attempted to do a GET in the browser without the project-id and got a 500
Cannot create pool with API, would need methods exposed

/projects/ - Query getALL /projects with no fields yields a 500 ("Database Error") - 0b48b9b9-3c47-407e-bf24-664e1398ee85
Ensure documentation in swagger and in RTD mentions how it determines what a "Project" is. There exists a "AT_PROJECT_TABLE"
Must use the /projects endpoint to set a project (kind) instead of setting KIND in the locations endpoint: TODO: Add response if a user tries to set kind in locations
https://github.com/USACE/cwms-data-api/issues/1573
id vs name on the mask, id looks at the name
/projects/{name} - Query getOne /projects - works as expected
/projects/locations - Works as expected, make sure you are on 2026.03.09-develop or later
DELETE - /projects/{name} - Consider adding a comment on swagger about why you want one method over another. Be sure to mention the LOCATION will still exist, deleting from projects downgrades the kind. <INSERT CAUTIONARY TALE ABOUT DELETE ALL CASCADING down to locations/turbines/outlets/etc> : The base SITE TSIDs and location would remain.
DELETE_ALL does NOT cascade up, only down!