Unlink User from Merchant

delete

https://apiprod.fattlabs.com/team/user/{userId}/merchants/{merchantId}

Revokes a user's access to a specific merchant by soft-deleting the membership record. Only the specified merchant is affected — the user's access to other merchants and the user record itself are never modified. The caller must be an active admin of the merchant, or a system_admin. A caller cannot revoke their own access to the merchant they are currently acting on (self-lockout prevention). Removing the last admin from a merchant is blocked for non-system_admin callers.

Responses

200Access revoked successfully, or the membership was already revoked (idempotent).

403The caller is not an active admin of this merchant.

409The user has never been attached to this merchant (no membership record exists at all).

422Validation failed. Possible reasons include: unknown merchant or user ID, attempting to revoke your own access on the merchant you are currently using, or attempting to remove the last admin from a merchant (non-system_admin callers only).