API ReferenceTraces

Share a trace publicly

Set public-sharing metadata for a trace ID. This operation upserts the sharing record and returns 200 when is_public is supplied; it does not first verify that trace spans exist.

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, 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.

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

trace_unique_idstringRequired
Unique trace identifier.

Request

This endpoint expects an object.
is_publicbooleanRequired

Set true to make the trace public, or false to revoke public access.

Response

Trace sharing state updated.
trace_unique_idstring
is_publicboolean

Errors

400
Bad Request Error
401
Unauthorized Error