4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB

datasets

Update a dataset

Update dataset metadata such as the name, description, starred state, or tags.

patch/api/datasets/{id}/

Path parameters

idstring required

Dataset ID.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

namestring

Updated dataset name.

descriptionstring

Updated dataset description.

starredboolean

Whether the dataset is starred.

tagsstring[]

List of tag IDs to assign. Replaces existing tags.

Response

Updated dataset.

idstring

namestring

typestring

descriptionstring

created_atstring

updated_atstring

organizationinteger

unique_organization_idsstring[]

timestampsstring[]

log_countinteger

evaluatorstring

statusstring

running_statusstring

running_progressinteger

running_atstring

completed_annotation_countinteger

granularity'logs' | 'traces'

Evaluation unit. Immutable after dataset creation.