---
title: "Changes to Delete traces in bulk"
method: POST
path: "/api/traces/bulk/"
---

# Changes to Delete traces in bulk

`POST /api/traces/bulk/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 20 breaking, 5 info
- **2026-10-02** `b830b79cfd52`: 14 breaking, 28 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info
- **2026-08-13** `4e064cf81dae`: 15 info
- **2026-07-31** `c26d550029f8`: 6 breaking, 3 warning, 6 info
- **2026-07-26** `77d94e49bc7a`: 6 breaking, 28 warning, 45 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 20 breaking, 5 info
  - request body became required
  - the `filters/customer_identifier/value` request property's minItems was increased to `1`
  - the `filters/end_time/value` request property's minItems was increased to `1`
  - the `filters/environment/value` request property's minItems was increased to `1`
  - the `filters/error_count/value` request property's minItems was increased to `1`
  - the `filters/llm_call_count/value` request property's minItems was increased to `1`
  - the `filters/span_count/value` request property's minItems was increased to `1`
  - the `filters/start_time/value` request property's minItems was increased to `1`
  - the `filters/total_completion_tokens/value` request property's minItems was increased to `1`
  - the `filters/total_cost/value` request property's minItems was increased to `1`
  - the `filters/total_prompt_tokens/value` request property's minItems was increased to `1`
  - the `filters/total_tokens/value` request property's minItems was increased to `1`
  - the `filters/trace_unique_id/value` request property's minItems was increased to `1`
  - the `filters/unique_organization_id/value` request property's minItems was increased to `1`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `deleted_count` from the response with the `200` status
  - removed the required property `error_count` from the response with the `200` status
  - removed the required property `errors` from the response with the `200` status
  - removed the required property `message` from the response with the `200` status
  - removed the required property `success_count` from the response with the `200` status
  - api operation id `traces_bulkDeleteTraces` removed and replaced with `bulkDeleteTraces`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - api tag `Traces` added
  - api tag `traces` removed
  - added `#/components/schemas/BulkOperationResponse, subschema #2` to the response body `allOf` list for the response status `200`
- **2026-10-02** `b830b79cfd52`: 14 breaking, 28 info
  - removed the enum value `is` of the request property `filters/customer_identifier/operator`
  - removed the enum value `is` of the request property `filters/end_time/operator`
  - removed the enum value `is` of the request property `filters/environment/operator`
  - removed the enum value `is` of the request property `filters/error_count/operator`
  - removed the enum value `is` of the request property `filters/llm_call_count/operator`
  - removed the enum value `is` of the request property `filters/span_count/operator`
  - removed the enum value `is` of the request property `filters/start_time/operator`
  - removed the enum value `is` of the request property `filters/total_completion_tokens/operator`
  - removed the enum value `is` of the request property `filters/total_cost/operator`
  - removed the enum value `is` of the request property `filters/total_prompt_tokens/operator`
  - removed the enum value `is` of the request property `filters/total_tokens/operator`
  - removed the enum value `is` of the request property `filters/trace_unique_id/operator`
  - removed the enum value `is` of the request property `filters/unique_organization_id/operator`
  - the response's body type changed from no type to `object` for status `403`
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - the `operator` request property default value changed from `is` to ``
  - added the new `` enum value to the request property `filters/customer_identifier/operator`
  - added the new `` enum value to the request property `filters/end_time/operator`
  - added the new `` enum value to the request property `filters/environment/operator`
  - added the new `` enum value to the request property `filters/error_count/operator`
  - added the new `` enum value to the request property `filters/llm_call_count/operator`
  - added the new `` enum value to the request property `filters/span_count/operator`
  - added the new `` enum value to the request property `filters/start_time/operator`
  - added the new `` enum value to the request property `filters/total_completion_tokens/operator`
  - added the new `` enum value to the request property `filters/total_cost/operator`
  - added the new `` enum value to the request property `filters/total_prompt_tokens/operator`
  - added the new `` enum value to the request property `filters/total_tokens/operator`
  - added the new `` enum value to the request property `filters/trace_unique_id/operator`
  - added the new `` enum value to the request property `filters/unique_organization_id/operator`
  - …2 more
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `bulk-delete-traces` removed and replaced with `traces_bulkDeleteTraces`
- **2026-08-13** `4e064cf81dae`: 15 info
  - added the new optional `query` request parameter `end_time`
  - added the new optional `query` request parameter `environment`
  - added the new optional `query` request parameter `start_time`
  - added optional request body
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the required property `deleted_count` to the response with the `200` status
  - added the required property `error_count` to the response with the `200` status
  - added the required property `errors` to the response with the `200` status
  - added the required property `message` to the response with the `200` status
  - added the required property `success_count` to the response with the `200` status
- **2026-07-31** `c26d550029f8`: 6 breaking, 3 warning, 6 info
  - removed the request body
  - removed the required property `deleted_count` from the response with the `200` status
  - removed the required property `error_count` from the response with the `200` status
  - removed the required property `errors` from the response with the `200` status
  - removed the required property `message` from the response with the `200` status
  - removed the required property `success_count` from the response with the `200` status
  - deleted the `query` request parameter `end_time`
  - deleted the `query` request parameter `environment`
  - deleted the `query` request parameter `start_time`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
- **2026-07-26** `77d94e49bc7a`: 6 breaking, 28 warning, 45 info
  - removed the enum value `` of the request property `filters/customer_identifier/operator`
  - removed the enum value `` of the request property `filters/total_tokens/operator`
  - removed the enum value `` of the request property `filters/trace_unique_id/operator`
  - removed the enum value `iexact` of the request property `filters/customer_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/total_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/trace_unique_id/operator`
  - removed the request property `filters/cache_hit`
  - removed the request property `filters/cache_key`
  - removed the request property `filters/completion_tokens`
  - removed the request property `filters/cost`
  - removed the request property `filters/custom_identifier`
  - removed the request property `filters/evaluator_id`
  - removed the request property `filters/group_identifier`
  - removed the request property `filters/is_root_span`
  - removed the request property `filters/latency`
  - removed the request property `filters/log_type`
  - removed the request property `filters/messages`
  - removed the request property `filters/metadata`
  - removed the request property `filters/model`
  - removed the request property `filters/positive_feedback`
  - removed the request property `filters/prompt_id`
  - removed the request property `filters/prompt_tokens`
  - removed the request property `filters/span_name`
  - removed the request property `filters/span_parent_id`
  - removed the request property `filters/span_workflow_name`
  - removed the request property `filters/status`
  - removed the request property `filters/status_code`
  - removed the request property `filters/stream`
  - removed the request property `filters/thread_identifier`
  - removed the request property `filters/tools`
  - removed the request property `filters/unique_id`
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `429` status
  - removed the optional property `matched_count` from the response with the `400` status
  - added the new optional request property `filters/end_time`
  - added the new optional request property `filters/environment`
  - added the new optional request property `filters/error_count`
  - added the new optional request property `filters/llm_call_count`
  - added the new optional request property `filters/span_count`
  - added the new optional request property `filters/start_time`
  - …39 more

---

[Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/traces/bulk/post.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/traces/bulk/post)
