---
title: "Bulk delete traces"
method: POST
path: "/api/traces/bulk/"
tags: ["traces"]
---

# Bulk delete traces

`POST /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.

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time
- `environment` string

## Headers

- `Authorization` string, required

## Request body

- object
  - `filters` Filters, required — Filter criteria. See [Filters API Reference](/docs/apis/reference/filters-api-reference) for operator syntax.
    - `status` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `status_code` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `unique_id` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `customer_identifier` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `thread_identifier` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `custom_identifier` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `group_identifier` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `prompt_id` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `trace_unique_id` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `span_parent_id` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `is_root_span` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `span_workflow_name` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `span_name` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `model` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `log_type` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `stream` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `tools` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `cache_hit` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `cache_key` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `prompt_tokens` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `completion_tokens` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `total_tokens` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `cost` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `latency` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `metadata` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `messages` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `positive_feedback` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown
    - `evaluator_id` FilterValue — A filter condition with an operator and value.
      - `operator` '' | 'iexact' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'icontains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'not' — Comparison operator. Empty string for exact match.
      - `value` unknown[], required — Value(s) to filter by.
        - unknown

## Response `200`

Bulk delete result.

- TracesBulkDeleteTracesResponse200
  - `deleted_count` integer, required — Number of traces deleted.
  - `message` string, required — Bulk delete result message.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing/invalid authentication
- `429` — Rate Limited
- `500` — Internal Server Error

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/58a2eabdccf3/schema)