|docs
Start Trial

Upload CSV records

Uploads a CSV file of enrichment records into an existing schema, as multipart/form-data or text/csv. The file is accepted for asynchronous processing (returns 202) and is limited to 10 MB. The CSV columns must align with the schema's fields: missing columns result in empty values and extra columns are ignored. Records are keyed by their query-field values, so uploading a row whose query values match an existing record updates that record.

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<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

schema_id*string

The ID of the enrichment schema.

Formatuuid

Query Parameters

filename?string

The filename for the CSV content. Required when creating a schema from a text/csv body; optional for text/csv record uploads. Ignored for multipart/form-data and JSON requests.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

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

Request Body

The CSV file to upload into the schema, as multipart/form-data or text/csv. The file is streamed for asynchronous processing and is limited to 10 MB. The CSV columns must align with the schema's fields: missing columns result in empty values and extra columns are ignored. Records are keyed by their query-field values, so uploading a row whose query values match an existing record updates that record.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json