Skip to main content
POST
Error
Required Permissions How permissions work

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.

Authentication alone is not sufficient in Bifrost Enterprise: each operation page shows a Required Permissions table (Resource:Operation, for example Dashboard:View) above its Authorizations section, and the caller's RBAC role or management API key scopes must include what it lists, otherwise the request is rejected with 403 Forbidden.

A local admin — authenticated with the admin password, or any caller on a deployment with dashboard auth disabled — bypasses these checks and can call every management endpoint. See Required permissions for how permissions are derived and which endpoints are exempt.

Body

application/json

Recalculate cost request

filters
object

Log search filters

Response

Cost recalculation job accepted

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