Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "status": "pending",
  "total": 123,
  "processed": 123,
  "updated": 123,
  "skipped": 123,
  "unpriceable": 123,
  "message": "<string>",
  "last_error": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

Logging

Cancel log cost recalculation

Cancels the recalculation job selected by id, or the current in-flight recalculation when id is omitted. Cancellation stops further batches; cost updates already committed to log records are retained and are not rolled back. Logs that the job has not processed remain unchanged.

The response uses the same job-status shape as the status endpoint and includes the partial progress recorded at the time of the response. The worker may still be unwinding, so poll the status endpoint with the returned id to obtain its final counters. If the selected job has already reached a terminal state, the endpoint returns it unchanged.

POST

/

api

/

logs

/

recalculate-cost

/

cancel

Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "status": "pending",
  "total": 123,
  "processed": 123,
  "updated": 123,
  "skipped": 123,
  "unpriceable": 123,
  "message": "<string>",
  "last_error": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "provider": "anthropic",
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

a Bifrost management API key,
a dashboard session token issued by POST /api/session/login,
base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Query Parameters

id

string

Optional recalculation job ID. Omit to cancel the current in-flight recalculation.

Response

Recalculation cancellation accepted, or the selected job was already terminal

Recalculate cost job status

id

string

Background job ID

status

enum<string>

Current job status

Available options:

pending,

running,

completed,

failed,

cancelled,

idle

total

integer<int64>

Total matching logs queued for recalculation

processed

integer<int64>

Logs processed so far

updated

integer<int64>

Logs updated with new costs

skipped

integer<int64>

Logs skipped during processing

unpriceable

integer<int64>

Subset of skipped logs whose pricing inputs could not be recovered, so their existing cost was left unchanged.

message

string

Optional progress message

last_error

string

Last error encountered by the job

started_at

string<date-time>

Job start time

updated_at

string<date-time>

Last status update time