PApagerduty
Enrichment Schemas

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.

<!-- theme: warning -->

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

post/enrichment/schemas/{schema_id}/records

Request

Path parameters

schema_idstring uuid required

The ID of the enrichment schema.

Query parameters

filenamestring

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.

Headers

Acceptstring required

The Accept header is used as a versioning header.

Request body multipart/form-data

filestring binary required

The CSV file to upload (max 10 MB).

Response

The CSV file was accepted for asynchronous processing.

upload_idstring uuid

Unique identifier for the CSV upload operation.

schema_idstring uuid

The schema the CSV data is being uploaded to.

filenamestring nullable

Original filename of the uploaded CSV file.

size_bytesinteger

Size of the uploaded file in bytes.

statusstring

Status of the upload operation.

accepted_atstring date-time

Timestamp when the upload was accepted.

Changes

No recorded changes to this operation across all 1 revision of this API.