List Usage Revocations

Returns recent revocation requests for the project, newest first.

GET /v1/projects/:project_id/usage/revocations

Authentication

Authorization: Bearer <api-key>

Requires usage:read.

Path Parameters

Field	Required	Description
project_id	Yes	Project that owns the tasks.

Request Body

Empty. This GET endpoint accepts filters only through query parameters.

Query Parameters

Field	Required	Description
limit	No	Page size. Defaults to 50; maximum is 200.

Example

curl 'http://127.0.0.1:8080/v1/projects/proj_gateway/usage/revocations?limit=20' \
  -H 'Authorization: Bearer <api-key>'

Response

{
  "revocations": [
    {
      "id": "urv_001",
      "tenant_id": "t_001",
      "project_id": "proj_gateway",
      "mode": "raw_event_ids",
      "purpose": "revoke",
      "reason": "duplicate gateway report",
      "status": "completed",
      "requested_count": 2,
      "selected_count": 2,
      "succeeded_count": 2,
      "failed_count": 0,
      "created_at": 1781222400,
      "updated_at": 1781222410
    }
  ]
}