---
title: "Apply Scim Mapping Changes"
method: POST
path: "/scim/mappings/batch"
tags: ["scim"]
---

# Apply Scim Mapping Changes

`POST /scim/mappings/batch`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/scim/mappings/batch`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

Remove and add mappings together; any failure applies none of them.

## Request body

- ScimMappingChangesRequest: Mapping removals and additions to apply in one transaction.
  - `create` ExternalGroupMappingCreate[]
    - `external_group_id` string, uuid, required
    - `group_id` string, uuid, required
  - `delete` string[]

## Response `204`

Successful Response

## Other responses

- `404`: Mapping, external group, or group not found.
- `409`: SCIM connection is not active.
- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)