Skip to main content

Remove a member from the org

DELETE /v1/members/{user_id}

Owners only, and the way someone is offboarded. The last owner cannot be removed (409 invalid_state). API keys belong to the org, not to the person who created them, so they keep working; revoke the departing person's keys separately if their access should end with them.

Credential. A dashboard session token belonging to an owner of the organisation.

curl --fail-with-body -X DELETE "https://api-833252724876.us-central1.run.app/v1/members/usr_b2c3d4e5f6g7h8i9j0k1" \
-H "Authorization: Bearer $JEAN_SESSION_TOKEN"

Path

NameTypeRequiredNotes
user_idstringyes

Response · 204

Successful Response

Errors

StatusMeaning
401Unauthenticated, invalid token or revoked key.
403Forbidden, session required or org required.
404No such resource in this org.
409An org must keep at least one owner; this would remove the last.
422Validation failed.
429Quota or rate limit exceeded; error.details says which, and when.
500Internal error; quote error.request_id when reporting it.

Every one carries the same envelope.

API overview · Full contract