---
title: "Replace SCIM User"
method: PUT
path: "/scim/Users/{id}"
tags: ["scim"]
---

# Replace SCIM User

`PUT /scim/Users/{id}`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/scim/Users/{id}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

## Request body

- ScimUser
  - `schemas` string[], required
  - `id` string
  - `externalId` string
  - `userName` string, required
  - `displayName` string
  - `active` boolean
  - `locale` string
  - `name` ScimName
    - `givenName` string, nullable
    - `familyName` string, nullable
    - `formatted` string, nullable
  - `emails` ScimEmail[]
    - `value` string, required
    - `type` string
    - `primary` boolean
  - `roles` union[]
    - union
      - string
      - ScimRole
        - `value` string
        - `display` string
        - `type` string
        - `primary` boolean
  - `groups` object[]
  - `meta` object

## Response `200`

SCIM User resource.

- ScimUser
  - `schemas` string[], required
  - `id` string
  - `externalId` string
  - `userName` string, required
  - `displayName` string
  - `active` boolean
  - `locale` string
  - `name` ScimName
    - `givenName` string, nullable
    - `familyName` string, nullable
    - `formatted` string, nullable
  - `emails` ScimEmail[]
    - `value` string, required
    - `type` string
    - `primary` boolean
  - `roles` union[]
    - union
      - string
      - ScimRole
        - `value` string
        - `display` string
        - `type` string
        - `primary` boolean
  - `groups` object[]
  - `meta` object

## Other responses

- `default`: SCIM 2.0 error envelope (RFC 7644 §3.12). Uses application/scim+json with the SCIM Error schema URN, status as a string, optional scimType for the specific error class.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)