Remove a SAML group mapping

DELETE

/api/admin/saml/group-mappings

Maintainer:Not configured

OperationId:admin_remove_saml_group_mapping

Removes one mapping. Memberships it already conferred are left in place: the IdP reconcile governs them, and at each member's next login removes those no remaining mapping confers. The answer counts the team's IdP memberships and says so. Recorded as saml_group_mapping_changed. Requires a system admin.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Removed

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/api/admin/saml/group-mappings?idp_key=undefined&group=undefined&team_id=undefined' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "idp_memberships_left_in_place": 0,
    "memberships": "string",
    "removed": {
        "group": "string",
        "idp_key": "string",
        "role": "owner",
        "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba"
    }
}

Modified at 2026-11-12 01:26:26

Remove an erasure retention policy

Read the admin ledger