Skip to main content
DELETE
Delete spans

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Body

application/json

Body containing span IDs to delete

project_id
string
required

The project ID containing the spans to delete

span_ids
string[]
required

List of span IDs to delete (maximum 5000)

Required array length: 1 - 5000 elements
start_time
string<date-time>

Scope the delete to spans starting at or after this timestamp (inclusive). ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Each bound is independent: omitting start_time defaults to two years ago; omitting end_time defaults to now. You may provide either or both.

end_time
string<date-time>

Scope the delete to spans starting before this timestamp (exclusive). ISO 8601 format (e.g., 2024-01-02T00:00:00Z). Each bound is independent: omitting start_time defaults to two years ago; omitting end_time defaults to now. You may provide either or both.

Response

Spans deleted. The response body always includes:

  • completed: whether all requested spans were fully processed. This endpoint is idempotent — retries are safe.
  • deleted_span_ids: IDs of spans confirmed deleted.
  • not_deleted_span_ids: IDs of spans not deleted — either not found, or not yet processed when completed is false.

Result of a DELETE /v2/spans request.

deleted_span_ids lists every span ID confirmed deleted. not_deleted_span_ids lists every requested span ID that was not deleted.

completed indicates whether the server fully processed all data for the request — not whether all spans were found and deleted. A span may appear in not_deleted_span_ids even when completed is true if it was not found in the system (never ingested or already deleted).

When completed is true, every requested ID appears in exactly one of deleted_span_ids or not_deleted_span_ids. No retry is needed.

When completed is false, the server could not fully process all data. Some IDs in not_deleted_span_ids may still be deletable — retry the original full request to resolve them. The delete is idempotent.

completed
boolean
required

true when the server fully processed all data for the request — both lists are complete and no retry is needed. false when processing could not fully complete; retry the original request. Note: completed reflects whether all data was processed, not whether all requested spans existed.

deleted_span_ids
string[]
required

Span IDs confirmed deleted in this request.

not_deleted_span_ids
string[]
required

Requested span IDs that were not deleted. When completed is true, these were not found in the system (never ingested or already deleted). When completed is false, some IDs may not have been reached — retry to resolve them.