---
title: "Update an SSO claim mapping"
method: PUT
path: "/v1/sso-claim-mapping/{id}"
tags: ["SSO Claim Mappings"]
---

# Update an SSO claim mapping

`PUT /v1/sso-claim-mapping/{id}`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/sso-claim-mapping/{id}`
- Auth: none declared

Updates an existing SSO claim mapping

## Path parameters

- `id` string, required

## Request body

- WriteSsoClaimMapping
  - `claimKey` string, required
  - `claimValue` string, required
  - `roleIds` string[], required
  - `teamAssignments` TeamAssignment[], required
    - `role` 'LEADER' | 'MEMBER', required: The role within the team
    - `teamId` string, required: The ID of the team
    - `teamName` string: Team name (response-only, enriched by server)

## Response `200`

Claim mapping updated successfully

- ReadSsoClaimMapping
  - `claimKey` string, required: JWT claim key to match
  - `claimValue` string, required: JWT claim value to match
  - `createdAt` string, date-time, required: When the mapping was created
  - `id` string, required: Unique identifier of the claim mapping
  - `roles` SsoClaimMappingRole[], required: Organization roles to assign when claim matches
    - `id` string, required: Role identifier
    - `name` string, required: Role name
  - `teamAssignments` TeamAssignment[], required: Team assignments to apply when claim matches
    - `role` 'LEADER' | 'MEMBER', required: The role within the team
    - `teamId` string, required: The ID of the team
    - `teamName` string: Team name (response-only, enriched by server)
  - `updatedAt` string, date-time, required: When the mapping was last updated

## Other responses

- `400`: Invalid request data (missing required fields, invalid role/team IDs, or validation failed)
- `403`: Insufficient permissions
- `404`: Claim mapping not found
- `409`: Claim mapping with this key-value pair already exists

---

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