---
title: "Preview Mappings"
method: POST
path: "/sso-group-mappings/preview"
tags: ["SSO Group Mappings"]
deprecated: true
---

# Preview Mappings

`POST /sso-group-mappings/preview`

> **Deprecated.**

Preview how external SSO groups would resolve to teams and roles.

## Request body

- SSOPreviewRequest
  - `external_groups` string[], required

## Response `200`

Successful Response

- SSOPreviewResponse
  - `team_results` PreviewTeamMatch[]
    - `user_group_id` integer, required
    - `source_group` string, required
  - `role_result` PreviewRoleMatch
    - `role` string, required
    - `source_group` string, required
  - `matched_teams` integer
  - `unmatched_count` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)