Projects

Upsert Project

Changed on

Create or update a project with a specific ID (upsert).

Returns 201 for creation, 200 for update. Returns 404 if owned by another user (avoids leaking existence). A name collision fails loud as 409 on both the create and update paths (unlike POST, which auto-renames).

workspace_id is out of scope: FolderCreate cannot express it, so a synced project inherits NULL exactly like one created via POST. Workspace assignment is not part of the upsert contract.

put/api/v1/projects/{project_id}

Request

  • The document declares no server URL.
  • Auth
    • OAuth 2
      Password
      Token URL: api/v1/login
    • or API key in query parameter x-api-key
    • or API key in header x-api-key

Path parameters

project_idstring uuid required

Request body

auth_settingsobject nullable

Authentication settings for the folder/project

components_liststring[] nullable
descriptionstring nullable
flows_liststring[] nullable
namestring required

Response

Successful Response

auth_settingsobject nullable

Authentication settings for the folder/project

descriptionstring nullable
idstring uuid required
namestring required
parent_idstring uuid nullable required

Changes