/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Transfer Ownership

Transfer Ownership

Make another member the workspace owner.

POST/v1/orgs/{orgId}/transferTry it
Session token

Makes another member of the workspace an owner. You become an admin in the same step. Any other owners keep their role.

Note

Requires the owner role and a session JWT. API keys are rejected with 401. An admin or member gets 403 forbidden with details.requiredRole: "owner" — see Role errors. Any plan.

Path Parameters

NameDescription
orgId:stringpathRequired
The organization ID.

Request Body

NameDescription
memberId:stringbodyRequired
The membership id of the new owner, from List Members — not their user id.

Response — 200 OK

The transfer is recorded in the audit log as org.ownership.transferred.

Error Responses

400 Bad Request

bad_request — memberId is your own membership ("You already own this workspace."). A missing memberId returns 400 validation_error, with the problem in details.issues.

401 Unauthorized

unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session has been signed out.

403 Forbidden

forbidden with details.requiredRole: "owner" when you are an admin or member ("Only the workspace owner can transfer ownership."). Without role details, you don't belong to the workspace.

404 Not Found

not_found — the workspace doesn't exist or is deleted, or memberId is not a member of this workspace ("Member not found").

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/orgs/3f9c2a1e-6b4d-4e8a-a1c7-5d2e9f0b7c13/transfer \
-H "Authorization: Bearer $SYNTEXT_JWT" \
-H "Content-Type: application/json" \
-d '{ "memberId": "a2c4e6f8-1b3d-4f5a-8c7e-9d0b2f4a6c81" }'
Responseapplication/json
200OK
{
"data": {
"transferred": true,
"ownerMemberId": "a2c4e6f8-1b3d-4f5a-8c7e-9d0b2f4a6c81"
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext