Skip to main content
POST
/
projects
Create Project
curl --request POST \
  --url https://api.example.com/projects

​
POST /projects

Creates a new project in the workspace. Every project must be linked to an existing location record.

​
Notes

  • Requires workspace write access.
  • At least one of locationId (workspace-scoped index) or globalLocationId (Snowflake ID) must be provided to associate the project with a location.
  • The status field defaults to "prospecting" if not specified. Valid values: prospecting, development, financing, construction, operating, archived.
  • Optional fields include timezoneOverride (UTC offset in hours, e.g. -5.0), boundaryGeometry (GeoJSON Polygon), and projectDetails (arbitrary metadata dict).
  • The referenced location must already exist in the workspace. Create one via POST /locations first if needed.
  • Returns the full project resource on success.