API ReferenceSpans

Update a span

Update mutable fields of a span. Supports pinning for infinite retention, user feedback, text annotations, and metadata (merged with existing metadata).

Authentication

AuthorizationBearer

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

unique_idstringRequired
The unique identifier of the span

Request

This endpoint expects an object.
is_pinnedbooleanOptional
Pin the span for infinite retention.
positive_feedbackboolean or nullOptional

User feedback. true = positive, false = negative, null = clear.

notestringOptional

Free-text annotation on the span.

metadataobjectOptional
Metadata to merge into existing span metadata.

Response

Span updated successfully

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error