Skip to main content

Workspace Ownership

Transfer workspace ownership to another member.

Base Path: /api/v1/workspaces/{workspaceId} Authentication: Required (Bearer Token) Tag: Workspace Ownership


Transfer Ownership

Transfer workspace ownership from the current owner to another member.

POST /workspaces/{workspaceId}/transfer

Path Parameters

ParameterTypeDescription
workspaceIdUUIDWorkspace ID

Request Body

{
"newOwnerId": "990e8400-e29b-41d4-a716-446655440000"
}
FieldTypeRequiredDescription
newOwnerIdUUIDYesUser ID of the new owner

Response

{
"success": true,
"data": {
"workspaceId": "660e8400-e29b-41d4-a716-446655440000",
"previousOwnerId": "880e8400-e29b-41d4-a716-446655440000",
"newOwnerId": "990e8400-e29b-41d4-a716-446655440000",
"transferredAt": "2025-01-15T10:30:00Z"
}
}

Response Type: ApiResponse<TransferOwnershipResponse>

:::danger Important

  • Only the current OWNER can transfer ownership
  • The new owner must be an existing member of the workspace
  • The previous owner's role will be changed to ADMIN
  • The new owner's role will be set to OWNER
  • A notification is sent to the new owner :::