> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List SCIM schemas

> Returns the SCIM 2.0 resource schemas supported by Attio (User and Group), allowing SCIM clients to discover supported attributes.

Required scopes: `user_management:read`.

<h4 style={{borderBottom:"none"}}>Authorizations</h4>

<ParamField header="Authorization" type="string" required>
  This API uses OAuth 2.0 with the authorization code grant flow.
</ParamField>

<h4 style={{borderBottom:"none"}}>Response</h4>

<ResponseField name="schemas" type="string[]">
  Always `["urn:ietf:params:scim:api:messages:2.0:ListResponse"]`.
</ResponseField>

<ResponseField name="totalResults" type="integer">
  Total number of schemas returned.
</ResponseField>

<ResponseField name="startIndex" type="integer">
  Always `1`.
</ResponseField>

<ResponseField name="itemsPerPage" type="integer">
  Number of schemas in this response.
</ResponseField>

<ResponseField name="Resources" type="object[]">
  The supported schemas. Each entry describes a resource type (`User` or `Group`) and its attributes.
</ResponseField>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
    "totalResults": 2,
    "startIndex": 1,
    "itemsPerPage": 2,
    "Resources": [
      {
        "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Schema"],
        "id": "urn:ietf:params:scim:schemas:core:2.0:User",
        "name": "User",
        "description": "Attio workspace member",
        "attributes": [
          {
            "name": "userName",
            "type": "string",
            "multiValued": false,
            "description": "Primary email of the user",
            "required": true,
            "mutability": "readWrite",
            "returned": "default",
            "uniqueness": "server"
          },
          {
            "name": "name",
            "type": "complex",
            "multiValued": false,
            "description": "The user's name",
            "required": false,
            "mutability": "readWrite",
            "returned": "default",
            "subAttributes": [
              {
                "name": "givenName",
                "type": "string",
                "multiValued": false,
                "description": "The user's first name",
                "required": false,
                "mutability": "readWrite",
                "returned": "default"
              },
              {
                "name": "familyName",
                "type": "string",
                "multiValued": false,
                "description": "The user's last name",
                "required": false,
                "mutability": "readWrite",
                "returned": "default"
              }
            ]
          },
          {
            "name": "emails",
            "type": "complex",
            "multiValued": true,
            "description": "Email addresses for the user",
            "required": false,
            "mutability": "readOnly",
            "returned": "default",
            "subAttributes": [
              {
                "name": "value",
                "type": "string",
                "multiValued": false,
                "description": "The email address",
                "required": false,
                "mutability": "readOnly",
                "returned": "default"
              },
              {
                "name": "primary",
                "type": "boolean",
                "multiValued": false,
                "description": "Whether this is the primary email address",
                "required": false,
                "mutability": "readOnly",
                "returned": "default"
              },
              {
                "name": "type",
                "type": "string",
                "multiValued": false,
                "description": "The type of email address",
                "required": false,
                "mutability": "readOnly",
                "returned": "default"
              }
            ]
          },
          {
            "name": "active",
            "type": "boolean",
            "multiValued": false,
            "description": "A Boolean value indicating the User's access to a workspace",
            "required": false,
            "mutability": "readWrite",
            "returned": "default",
            "uniqueness": "none"
          },
          {
            "name": "appRole",
            "type": "string",
            "multiValued": false,
            "description": "The user's access level within the workspace. Can be set to 'admin' or 'member'.",
            "required": false,
            "canonicalValues": ["admin", "member"],
            "mutability": "readWrite",
            "returned": "default",
            "uniqueness": "none"
          }
        ],
        "meta": {
          "resourceType": "Schema",
          "location": "/scim/v2/Schemas/urn:ietf:params:scim:schemas:core:2.0:User"
        }
      },
      {
        "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Schema"],
        "id": "urn:ietf:params:scim:schemas:core:2.0:Group",
        "name": "Group",
        "description": "Attio's team",
        "attributes": [
          {
            "name": "displayName",
            "type": "string",
            "multiValued": false,
            "description": "A human-readable name for the team",
            "required": true,
            "mutability": "readWrite",
            "returned": "default",
            "uniqueness": "none"
          },
          {
            "name": "members",
            "type": "complex",
            "multiValued": true,
            "description": "Members of the group",
            "required": false,
            "mutability": "readWrite",
            "returned": "default",
            "subAttributes": [
              {
                "name": "value",
                "type": "string",
                "multiValued": false,
                "description": "Workspace membership ID or workspace invite ID",
                "required": false,
                "mutability": "readWrite",
                "returned": "default"
              },
              {
                "name": "$ref",
                "type": "reference",
                "multiValued": false,
                "description": "URI reference for the member",
                "required": false,
                "mutability": "readWrite",
                "returned": "default"
              },
              {
                "name": "type",
                "type": "string",
                "multiValued": false,
                "description": "The type of the member resource",
                "required": false,
                "mutability": "readWrite",
                "returned": "default"
              }
            ]
          }
        ],
        "meta": {
          "resourceType": "Schema",
          "location": "/scim/v2/Schemas/urn:ietf:params:scim:schemas:core:2.0:Group"
        }
      }
    ]
  }
  ```
</ResponseExample>