> Documentation index for AI agents: https://docs.pagerduty.com/llms.txt # Get SCIM Schemas `GET https://api.pagerduty.com/scim/v2/Schemas` Retrieves the SCIM schemas supported by the service provider. Scoped OAuth requires: `users.read` ## Authorization - **apiKey** (apiKey) — `Authorization` header. A [General Access API Key](https://support.pagerduty.com/main/docs/api-access-keys#generate-a-general-access-rest-api-key) with format `Token token=` - **bearerToken** (http) — HTTP bearer. An [App OAuth Token](https://docs.pagerduty.com/developer/private-apps) with format `Bearer ` ## Response 200 SCIM Schemas List ### `application/scim+json` | Field | Type | Required | Description | |---|---|---|---| | `Resources` | array of object | yes | A multi-valued list of complex objects containing the requested resources. Default: `[]`. | | `Resources[].attributes` | array of object | yes | A complex type that specifies the set of attributes that make up the schema. | | `Resources[].attributes[].canonicalValues` | array of string | | A list of canonical values. When specified, service providers MUST restrict accepted values to the specified values. | | `Resources[].attributes[].caseExact` | boolean | yes | A Boolean value indicating whether the attribute is case sensitive. | | `Resources[].attributes[].description` | string | yes | The attribute's human-readable description. Min length: 1. | | `Resources[].attributes[].multiValued` | boolean | yes | A Boolean value indicating whether the attribute can have multiple values. | | `Resources[].attributes[].mutability` | string | yes | Indicates whether the attribute is modifiable. One of: `readOnly`, `readWrite`, `immutable`, `writeOnly`. | | `Resources[].attributes[].name` | string | yes | The attribute's name. Min length: 1. | | `Resources[].attributes[].required` | boolean | yes | A Boolean value indicating whether the attribute is required. | | `Resources[].attributes[].returned` | string | yes | Indicates when the attribute is returned. One of: `always`, `never`, `default`, `request`. | | `Resources[].attributes[].subAttributes` | array of object | | List of sub-attributes for complex attributes. | | `Resources[].attributes[].type` | string | yes | The attribute's data type. One of: `string`, `boolean`, `decimal`, `integer`, `dateTime`, `reference`, `complex`. | | `Resources[].attributes[].uniqueness` | string | yes | Indicates how unique a value must be. One of: `none`, `server`, `global`. | | `Resources[].description` | string | yes | The schema's human-readable description. Min length: 1. | | `Resources[].id` | string (uri) | yes | The unique identifier for the schema. Min length: 1. Pattern: `^urn:.*`. | | `Resources[].meta` | object | yes | | | `Resources[].meta.resourceType` | string | yes | The resource type. | | `Resources[].name` | string | yes | The schema's human-readable name. Min length: 1. | | `Resources[].schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:schemas:core:2.0:Schema"]`. Min items: 1. Items must be unique. | | `itemsPerPage` | integer | yes | The number of resources returned in a list response page. Default: `100`. Minimum: 0. | | `schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:api:messages:2.0:ListResponse"]`. Min items: 1. Items must be unique. | | `startIndex` | integer | yes | The 1-based index of the first result in the current set of query results. Default: `1`. Minimum: 1. | | `totalResults` | integer | yes | The total number of results matching the client query. Default: `0`. Minimum: 0. | ## Response 400 Bad Request ### `application/scim+json` | Field | Type | Required | Description | |---|---|---|---| | `detail` | string | yes | Detailed error explanation. | | `schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:api:messages:2.0:Error"]`. Min items: 1. Items must be unique. | | `scimType` | string | | SCIM error type. One of: `invalidFilter`, `tooMany`, `uniqueness`, `mutability`, `invalidSyntax`, `invalidPath`, `noTarget`, `invalidValue`, `invalidVers`, `sensitive`. | | `status` | string | yes | HTTP status code for the error. | ## Response 401 Unauthorized ### `application/scim+json` | Field | Type | Required | Description | |---|---|---|---| | `detail` | string | yes | Detailed error explanation. | | `schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:api:messages:2.0:Error"]`. Min items: 1. Items must be unique. | | `scimType` | string | | SCIM error type. One of: `invalidFilter`, `tooMany`, `uniqueness`, `mutability`, `invalidSyntax`, `invalidPath`, `noTarget`, `invalidValue`, `invalidVers`, `sensitive`. | | `status` | string | yes | HTTP status code for the error. | ## Response 403 Forbidden ### `application/scim+json` | Field | Type | Required | Description | |---|---|---|---| | `detail` | string | yes | Detailed error explanation. | | `schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:api:messages:2.0:Error"]`. Min items: 1. Items must be unique. | | `scimType` | string | | SCIM error type. One of: `invalidFilter`, `tooMany`, `uniqueness`, `mutability`, `invalidSyntax`, `invalidPath`, `noTarget`, `invalidValue`, `invalidVers`, `sensitive`. | | `status` | string | yes | HTTP status code for the error. | ## Response 500 Internal Server Error ### `application/scim+json` | Field | Type | Required | Description | |---|---|---|---| | `detail` | string | yes | Detailed error explanation. | | `schemas` | array of string (uri) | yes | URIs that indicate the schemas used in data. Default: `["urn:ietf:params:scim:api:messages:2.0:Error"]`. Min items: 1. Items must be unique. | | `scimType` | string | | SCIM error type. One of: `invalidFilter`, `tooMany`, `uniqueness`, `mutability`, `invalidSyntax`, `invalidPath`, `noTarget`, `invalidValue`, `invalidVers`, `sensitive`. | | `status` | string | yes | HTTP status code for the error. | ## Developer Agreement Your access to and use of the PagerDuty Developer Services is governed by the [PagerDuty Developer Agreement](https://docs.pagerduty.com/developer/pagerduty-developer-agreement).