DAdatadog
Logs Archive Searches

Cancel an Archive Search

Cancel a running Archive Search. Cancelling an Archive Search that has already finished is a no-op: it returns the resource unchanged instead of returning an error.

post/api/v2/logs/archive_searches/{archive_search_id}/cancel

Request

Path parameters

archive_search_idstring required

Unique identifier of the Archive Search.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "archive_id": "mhmyYmyLTOaFYKvhNadu1w",
      "bytes_scanned": 402764439,
      "completed_at": "2026-01-02T12:30:00Z",
      "created_at": "2026-01-02T12:00:00Z",
      "description": "Investigating the checkout latency spike.",
      "events_scanned": 1500,
      "expected_duration": 120,
      "from": "2026-01-01T00:00:00Z",
      "name": "checkout-latency-investigation",
      "query": "service:checkout status:error",
      "rehydration": {
        "max_rehydrated_events": 1000000,
        "retention_days": 15,
        "tier": "standard"
      },
      "status": "RUNNING",
      "to": "2026-01-02T00:00:00Z"
    },
    "id": "nv2eu4srgyzdkulggjzg2zkmmzifa2rum5iq",
    "type": "archive_search"
  }
}

Changes

Changes to this operation have not been checked yet.