Skip to navigation
SaaS APIprojects

Update project assignments

View as Markdown

Add or remove project member and agent assignments in an Enterprise workspace. Added IDs may be unassigned or already assigned to this project; an ID assigned to another project returns entity_already_assigned. Removed IDs are detached only from this project. All workspace members except viewers may write; PATs require the write scope.

Path parameters

idstringRequiredformat: "uuid"
Project UUID

Headers

AuthorizationstringRequired

Bearer {access_token}

X-Workspace-IdstringRequiredformat: "uuid"
Workspace UUID

Request

At least one add/remove array must contain an ID

addAgentIdslist of stringsOptional

Agent UUIDs to attach to this project. Each agent may be unassigned or already assigned to this project; assignment to another project returns entity_already_assigned.

addMemberIdslist of stringsOptional

Member UUIDs to attach to this project. Each member may be unassigned or already assigned to this project; assignment to another project returns entity_already_assigned.

removeAgentIdslist of stringsOptional

Agent UUIDs to detach from this project; agents assigned elsewhere are not changed.

removeMemberIdslist of stringsOptional

Member UUIDs to detach from this project; members assigned elsewhere are not changed.

Response

data: projectId, before, after

dataobjectOptional

Errors

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