Skip to the page

Offer ownership to a person in the organisation (owner); it changes when they accept

POST/v1/organisations/{id}/transfers

Operation organisations.offerOwnership · since 2026-11-05 · stable

Needs a session withwritescopeAnswers201 Created

Nothing changes until they accept.

Path parameters

idstring (uuid)required
The organisation id.

Body (JSON)

memberIdstring (uuid)required
The person in the organisation to offer ownership to.
stepDownbooleanoptional
True (default): you step down from owner when they accept. False: they become a second owner.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer.

POST/v1/organisations/{id}/transfers
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/transfers" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "memberId": "00000000-0000-4000-8000-000000000001",
  "stepDown": true
}'
With the rykloud CLI
rykloud orgs transfer ORG MEMBER [flags]

Command reference: rykloud orgs transfer