Delete a trace | Respan Docs

Delete a single trace by trace_unique_id. start_time and end_time can be provided to narrow the request to the relevant time range.

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

trace_unique_idstringRequired

Unique trace identifier.

Query parameters

start_timedatetimeOptional

Start of time range (ISO 8601). Defaults to one hour before end_time when omitted.

end_timedatetimeOptional

End of time range (ISO 8601). Defaults to now when omitted.

Response

Trace delete issued successfully.

messagestring

Delete confirmation message.

Errors

401

Unauthorized Error

500

Internal Server Error