For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTList traces
      • POSTBulk delete traces
      • GETRetrieve a trace
      • DELDelete a trace
      • PATCHShare a trace publicly
      • GETRetrieve a public trace
      • POSTIngest spans from traces (v1 legacy)
      • POSTCreate a trace (OTLP)
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceTraces

Delete a trace

DELETE
https://api.respan.ai/api/traces/:trace_unique_id/
DELETE
/api/traces/:trace_unique_id/
$curl -X DELETE "https://api.respan.ai/api/traces/trace_unique_id/?start_time=2025-01-01T00%3A00%3A00Z&end_time=2025-01-31T23%3A59%3A59Z" \
>     -H "Authorization: Bearer sk_live_xxxxx"
1{
2  "message": "Successfully deleted trace trace_abc123"
3}

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.

Was this page helpful?
Previous

Share a trace publicly

Next
Built with

Path parameters

trace_unique_idstringRequired
Unique trace identifier.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

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