Remove Organization Member

DELETE /members/{user_id}

Remove Organization Member

Remove a member from the organization. Only an organization owner can do this, and the last owner cannot be removed.

The member's environment role bindings and team memberships go with them. Caller API keys they own are not deleted and keep working — the user_id already recorded on usage rows still resolves to them, so past traffic stays attributable. Delete or reassign those keys separately if the removal is meant to cut off their traffic.

Parameters

• user_id (path, string, required): User ID of the organization member.

Responses

• 200: Removed

• deleted (boolean, required):

• user_id (string, required):

• 400: Request body or parameters failed validation.

• error (object, required): Error details.

• error.code (string, required): Machine-readable identifier. Examples: UNAUTHENTICATED, INVALID_REQUEST, MASTER_KEY_UNSET, INTERNAL.

• error.message (string, required): Human-readable explanation; safe to surface to operators.

• 401: Missing or invalid bearer. Response fields (application/json): identical to DELETE /members/{user_id}, response 400 above.

• 403: Authenticated request is not permitted. Response fields (application/json): identical to DELETE /members/{user_id}, response 400 above.

• 404: Resource not found. Response fields (application/json): identical to DELETE /members/{user_id}, response 400 above.

• 409: The removal would remove the last owner. Response fields (application/json): identical to DELETE /members/{user_id}, response 400 above.

cURL

curl -X DELETE '$AISIX_CP/members/{user_id}' -H 'Authorization: Bearer $AISIX_TOKEN'