traces

Bulk delete traces

Delete multiple traces matching the given filters. This endpoint requires a non-empty filters object and rejects requests that match more than 1000 traces.

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

Request body

Response

Bulk delete result.

deleted_countinteger required

Number of traces deleted.

messagestring required

Bulk delete result message.

Changes