---
title: "Review Scim Activation"
method: POST
path: "/scim/activation/review"
tags: ["scim"]
---

# Review Scim Activation

`POST /scim/activation/review`

## Request

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

Report what the provider pushed and what activating would change.

A read: the returned plan is not stored, so activation recomputes it.

## Request body

- ScimReviewRequest: Mapping additions and removals to preview without applying them.
  - `mappings` ExternalGroupMappingCreate[]
    - `external_group_id` string, uuid, required
    - `group_id` string, uuid, required
  - `delete` string[]
  - `full` boolean

## Response `200`

Successful Response

- ScimActivationReviewRead: Who a proposed activation or mapping change affects, by outcome.
  - `joining` ScimReviewPeople, required: A counted list of people; ``items`` is a preview unless ``full`` was asked.
    - `count` integer, required
    - `items` ScimReviewPerson[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `groups` string[]
  - `leaving` ScimReviewPeople, required: A counted list of people; ``items`` is a preview unless ``full`` was asked.
    - `count` integer, required
    - `items` ScimReviewPerson[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `groups` string[]
  - `losing` ScimReviewPeople, required: A counted list of people; ``items`` is a preview unless ``full`` was asked.
    - `count` integer, required
    - `items` ScimReviewPerson[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `groups` string[]
  - `to_idp` ScimReviewPeople, required: A counted list of people; ``items`` is a preview unless ``full`` was asked.
    - `count` integer, required
    - `items` ScimReviewPerson[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `groups` string[]
  - `to_manual` ScimReviewPeople, required: A counted list of people; ``items`` is a preview unless ``full`` was asked.
    - `count` integer, required
    - `items` ScimReviewPerson[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `groups` string[]
  - `groups` ScimGroupTransitionRead[], required
    - `group_id` string, uuid, required
    - `group_name` string, required
    - `added_sources` string[], required
    - `removed_sources` string[], required
    - `gained` integer, required
    - `lost` integer, required
    - `takes_over` boolean

## Other responses

- `404`: SCIM connection, mapping, or group not found.
- `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)