Bulk delete traces

POST

https://api.respan.ai/api/traces/bulk/

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

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.

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.

environmentstringOptional

Filter by environment.

Request

This endpoint expects an object.

filtersobjectRequired

Filter criteria. See Filters API Reference for operator syntax.

Response

Bulk delete result.

deleted_countinteger

Number of traces deleted.

messagestring

Bulk delete result message.

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X POST "https://api.respan.ai/api/traces/bulk/?start_time=2025-01-01T00%3A00%3A00Z&end_time=2025-01-31T23%3A59%3A59Z&environment=prod" \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"filters": {
>	"customer_identifier": {
>	"value": [
>	"user_789"
>	],
>	"operator": ""
>	},
>	"model": {
>	"value": [
>	"gpt-4o-mini"
>	],
>	"operator": ""
>	},
>	"cost": {
>	"value": [
>	0.05
>	],
>	"operator": "gte"
>	}
>	}
>	}'

1	{
2	"deleted_count": 0,
3	"message": "No traces matched the given filters"
4	}