Update an enrichment schema

Updates the name and/or description of an enrichment schema. At least one of name or description must be provided. Schema fields cannot be changed after creation.

Early Access

This API is in Early Access and may change at any time. Contact your PagerDuty account team to request access.

Scoped OAuth requires: contextual_data.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

schema_id*string

The ID of the enrichment schema.

Formatuuid

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

The schema fields to update. At least one of name or description must be provided.

TypeScript Definitions

Use the request body type in TypeScript.

schema*

Response Body

`application/json`

curl -X PUT "https://api.pagerduty.com/enrichment/schemas/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "schema": {      "name": "Team Leads and Runbooks",      "description": "Attaches SME and Runbook URLs to incidents"    }  }'

{  "schema": {    "id": "9f194d8d-0f58-4c5c-b1d2-a5adf7171821",    "type": "enrichment_schema",    "integration_type": "CSV",    "name": "Team Leads and Runbooks",    "description": "Attaches SME and Runbook URLs to incidents",    "fields": [      {        "name": "Application",        "type": "query"      },      {        "name": "Manager",        "type": "enriched"      },      {        "name": "Runbook URL",        "type": "enriched"      }    ],    "created_at": "2026-06-30T15:17:30Z",    "updated_at": "2026-06-30T16:02:00Z",    "deleted_at": null  }}

Update an enrichment schema

Early Access

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`