Anthropic Gateway1

Behaviors11

Caches6

Credit Transactions2

Dashboard12

Error Groups5

Gateway2

Google Gateway1

Incidents3

Limit Policies5

Models15

OpenAI Batch9

OpenRouter Gateway1

Prompts19

Provider Gateway1

Respan Models1

Spans7

Temporary API Keys5

Traces8

TypeSafe Gateway1

Users4

Traces

Delete traces in bulk

Changed on Oct 21, 2026

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. Unknown fields and invalid operators return 400 before anything is deleted. 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/

Request

Base URL
https://api.respan.ai
URL
https://api.respan.ai/api/traces/bulk/
Auth
- HTTP bearer
- or HTTP bearer

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.

Request body

Example request

{
  "filters": {
    "customer_identifier": {
      "operator": "",
      "value": [
        "customer-123"
      ]
    }
  }
}

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.

Example response

{
  "success_count": 1,
  "error_count": 0,
  "errors": []
}

Changes

Oct 21, 2026c30bcb383ee8 Revision changes
- breaking
  request body became required
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  api operation id traces_bulkDeleteTraces removed and replaced with bulkDeleteTraces
- info
  the endpoint scheme security DashboardJwt was added to the API
- info
  api tag Traces added
- info
  api tag traces removed
- info
  added subschema #2 to the response body allOf list for the response status
Oct 2, 2026b830b79cfd52 Revision changes
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  removed the enum value is of the request property //
- breaking
  the response's body type changed from no type to object for status
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  the request property default value changed from is to
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  added the new enum value to the request property //
- info
  removed the non-success response with the status
- info
  added the required property to the response with the status

Operation history (4 revisions)