Members

Set the account owner

Makes the member in the body the account's OWNER and steps the calling owner down to ADMIN, so the account always keeps exactly one owner.

  • Repeatable: it states the desired owner rather than performing a transfer, so repeating the same call once that member already owns the account returns the same 204 instead of failing.
  • Credentials: unlike the rest of this API, this operation is available only from a signed-in dashboard session. No API key, live or test, can perform it, whatever scopes it holds.
  • From an integration: to hand an account over to its holder, issue a claim token with POST /v1/accounts/{account_id}/claim-tokens instead.
put/v1/accounts/{account_id}/owner

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/{account_id}/owner
  • Auth: API key in cookie BEEL_SESSION

Headers

Idempotency-Keystring

Idempotency key to prevent duplicates in sensitive operations.

  • Any unique client-generated string (e.g. an order id). A UUID also works but is not required
  • Allowed characters: letters, digits, _ and - (max 255 chars)
  • Retrying with the same key replays the first response when it was a success (2xx) or a server error (5xx): same status and body, plus the header Idempotency-Replay: true. After a 5xx, check whether the operation took effect before retrying with a new key
  • A 4xx is not stored: the key is released, so the corrected request can reuse it
  • Stored responses expire 24 hours after processing

The key is scoped per user and environment, and bound to the request body, so retrying after a network timeout replays the stored response instead of repeating the operation.

StatusCodeWhen
400INVALID_IDEMPOTENCY_KEYThe key breaks the format rules above.
409IDEMPOTENCY_KEY_PROCESSINGThe first request is still in flight. Wait for the Retry-After seconds (2) and retry with the same key.
409IDEMPOTENCY_KEY_MISMATCHThe key was already used with a different body. Use a new key.

Request body

member_idstring uuid required

Membership UUID of the member who becomes OWNER.

Response

Ownership set successfully

Changes

No recorded changes to this operation across all 1 revision of this API.