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").