Sign in
spans

Update a span

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

patch/api/request-logs/{unique_id}/

Path parameters

unique_idstring required

The unique identifier of the span

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

Request body

is_pinnedboolean

Pin the span for infinite retention.

positive_feedbackboolean nullable

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

notestring

Free-text annotation on the span.

metadataApiRequestLogsUniqueIdPatchRequestBodyContentApplicationJsonSchemaMetadata

Metadata to merge into existing span metadata.

Response

Span updated successfully

SpansUpdateSpanResponse200 required

Empty response body

Changes