4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
traces

Bulk delete traces

Delete traces matching a non-empty filter object. The endpoint resolves at most 1,000 trace IDs per request; requests matching more are rejected with 422. Use the query parameters for the canonical environment and time window; the same fields in the body only narrow that window. Only the documented filter fields and metadata__<key> are supported. The current server ignores unknown fields and invalid operators, which can broaden the deletion selection, so validate filters carefully before sending them. ClickHouse deletion is asynchronous, so success_count and deleted_count report traces submitted for deletion, not confirmation that every row has already disappeared. Rate limit: 10 requests per minute per organization and exact endpoint path for API-key calls (shared across API keys), and per user and exact endpoint path for JWT calls.

post/api/traces/bulk/

Query parameters

start_timestring date-time

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

end_timestring date-time

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

environmentstring

Filter by environment.

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

Request body

Response

Traces were matched and submitted for asynchronous deletion.

success_countinteger required

Number of items successfully processed.

error_countinteger required

Number of items that failed.

deleted_countinteger required

Number of resources matched and processed for deletion.

messagestring required

Human-readable deletion result.