Organization

Remove Member

Removes a person from your organization. Their API keys are revoked and their shared credentials are withdrawn from the org before the roster entry is dropped.

If the address has a pending invitation rather than a membership, the invitation is revoked — data.removed says which happened.

Check data.warnings. Removal is never blocked, so anything of theirs the org was relying on is affected: workflows using a connection they owned start failing, active sources they owned stop importing, and workflows they still own keep running — scheduled runs charge the owner, so the org keeps paying for them. Each warning names the affected resources so you can reassign them. An empty array means none of those checks found anything, not that the member was inconsequential.

Requires the members:write scope, which only an org admin's API key can carry. You cannot remove yourself.

Percent-encode the address: a literal + in a query string decodes to a space, so sam+team@acme.com must be sent as sam%2Bteam%40acme.com.

Refusals carry a code:

codeStatusMeaning
NOT_A_MEMBER404No member or pending invitation for that address
CANNOT_REMOVE_SELF403Another admin has to remove you
SSO_MEMBER_MANAGED_IN_IDP403Managed by your SSO provider — remove them there
LAST_LEAD / LAST_MEMBER409An org cannot be left with no admin or no members
delete/api/v1/org/members

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Query parameters

emailstring required

Email address of the member to remove, or of the pending invitation to revoke.

Response

Default Response

statusinteger
messagestring

Changes

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