SaaS SDKSaaS APIprojects

Create project

View as Markdown

Create a project for an Enterprise workspace. Optional initial member and agent assignments are applied atomically with project creation. All workspace members except viewers may write; PATs require the write scope.

Headers

AuthorizationstringRequired

Bearer {access_token}

X-Workspace-IdstringRequiredformat: "uuid"
Workspace UUID

Request

name (required), description, agentIds, memberIds

namestringRequiredformat: "\S">=1 character

Leading and trailing whitespace is trimmed; the trimmed name must contain 1-100 Unicode characters.

agentIdslist of stringsOptional
Agent UUIDs to assign atomically when the project is created.
descriptionstring or nullOptional<=1000 characters

Optional project description; null stores no description.

memberIdslist of stringsOptional
Member UUIDs to assign atomically when the project is created.

Response

data: created project

dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error