Get relay log by ID

Returns one relay log row, including request and response bodies and headers when content logging kept them. Requires the logs store; returns 503 when it is unavailable.

GET /api/relay-logs/{id}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "relay_name": "<string>",
  "kind": "call",
  "method": "<string>",
  "path": "<string>",
  "status": "success",
  "status_code": 123,
  "streamed": true,
  "billable": true,
  "bytes_out": 123,
  "request_id": "<string>",
  "content_hidden": true,
  "route_path": "<string>",
  "model": "<string>",
  "latency": 123,
  "upstream_latency": 123,
  "overhead_latency": 123,
  "overhead_breakdown": [
    {
      "name": "<string>",
      "duration_us": 123
    }
  ],
  "cost": 123,
  "cost_per_request": 123,
  "cost_per_unit": 123,
  "extracted_cost": 123,
  "units": 123,
  "billed_units": 123,
  "input_tokens": 123,
  "output_tokens": 123,
  "total_tokens": 123,
  "job_id": "<string>",
  "job_status": "<string>",
  "parent_log_id": "<string>",
  "user_id": "<string>",
  "user_name": "<string>",
  "virtual_key_id": "<string>",
  "virtual_key_name": "<string>",
  "team_id": "<string>",
  "team_name": "<string>",
  "customer_id": "<string>",
  "customer_name": "<string>",
  "business_unit_id": "<string>",
  "business_unit_name": "<string>",
  "project_id": "<string>",
  "project_name": "<string>",
  "team_ids": [
    "<string>"
  ],
  "team_names": [
    "<string>"
  ],
  "customer_ids": [
    "<string>"
  ],
  "customer_names": [
    "<string>"
  ],
  "business_unit_ids": [
    "<string>"
  ],
  "business_unit_names": [
    "<string>"
  ],
  "user_agent": "<string>",
  "app": "<string>",
  "request_body": "<string>",
  "response_body": "<string>",
  "plugin_logs": "<string>",
  "budget_ids": [
    "<string>"
  ],
  "rate_limit_ids": [
    "<string>"
  ],
  "request_headers": {},
  "response_headers": {},
  "error_details": {
    "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": {
      "routing_info": {
        "provider": "anthropic",
        "model": "<string>",
        "key": "<string>",
        "resolved_key_alias": {
          "model_id": "<string>",
          "model_name": "<string>",
          "model_family": "<string>"
        },
        "is_fallback": true,
        "primary_provider": "anthropic",
        "primary_model": "<string>",
        "requested_provider": "anthropic",
        "requested_model": "<string>",
        "server_side_fallback_model": "<string>"
      },
      "provider": "anthropic",
      "original_model_requested": "<string>",
      "resolved_model_used": "<string>",
      "request_type": "<string>",
      "mcp_request_type": "<string>",
      "a2a_request_type": "<string>",
      "a2a_agent_name": "<string>",
      "error_type": "<string>",
      "retry_after_ms": 150500,
      "raw_request": "<unknown>",
      "raw_response": "<unknown>",
      "converted_request_type": "<string>",
      "dropped_compat_plugin_params": [
        "<string>"
      ],
      "latency": 123,
      "key_statuses": [
        {
          "key_id": "<string>",
          "status": "success",
          "provider": "anthropic",
          "error": "<unknown>"
        }
      ],
      "mcp_auth_required": {
        "kind": "<string>",
        "mcp_client_id": "<string>",
        "mcp_client_name": "<string>",
        "message": "<string>",
        "authorize_url": "<string>",
        "session_id": "<string>",
        "subject_token_missing": true,
        "exchange_error": "<string>"
      },
      "billed_usage": {
        "prompt_tokens": 123,
        "prompt_tokens_details": {
          "text_tokens": 123,
          "audio_tokens": 123,
          "image_tokens": 123,
          "cached_read_tokens": 123,
          "cached_write_tokens": 123
        },
        "completion_tokens": 123,
        "completion_tokens_details": {
          "text_tokens": 123,
          "accepted_prediction_tokens": 123,
          "audio_tokens": 123,
          "citation_tokens": 123,
          "num_search_queries": 123,
          "reasoning_tokens": 123,
          "image_tokens": 123,
          "rejected_prediction_tokens": 123
        },
        "total_tokens": 123,
        "tool_usage": {
          "web_search": {
            "num_requests": 123
          }
        },
        "cost": {
          "input_tokens_cost": 123,
          "output_tokens_cost": 123,
          "reasoning_tokens_cost": 123,
          "citation_tokens_cost": 123,
          "search_queries_cost": 123,
          "request_cost": 123,
          "total_cost": 123
        }
      }
    }
  }
}

Required Permissions

Permission	Granted via
RelayLogs:View	RBAC role or API key scope

How permissions work

Authorizations

ManagementBearerAuthBasicAuth

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.

OSS setup lock. On Bifrost OSS, while dashboard auth is not active (no admin account, or auth disabled), every management endpoint except the public ones (/health, /api/version, /api/session/is-auth-enabled, /api/session/login, ...) requires the operator's setup token in the X-Bifrost-Setup-Token header, in place of Authorization. The token is set with setup_token in config.json or the BIFROST_SETUP_TOKEN environment variable. A missing header returns 401, a wrong token 403. The header stops working once dashboard auth is enabled. The dashboard instead trades the token once for an HttpOnly bifrost_setup_session cookie via POST /api/session/setup. See Required permissions for how permissions are derived and which endpoints are exempt.

Path Parameters

id · string · required

Relay log ID

Response

200

application/json

The relay log

One relayed call, or the job row a relayed call started.

id · string · required

timestamp · string<date-time> · required

created_at · string<date-time> · required

relay_name · string · required

kind · enum<string> · required

Available options: call, job

method · string · required

path · string · required

status · enum<string> · required

Available options: success, error, cancelled

status_code · integer · required

streamed · boolean · required

billable · boolean · required

bytes_out · integer<int64> · required

Response body bytes forwarded to the caller.

request_id · string · required

content_hidden · boolean · required

True when request and response content was not persisted for this call.

route_path · string

The matched route's path glob. Absent when no route matched.

model · string

latency · number

Milliseconds from the pre-hooks to the end of the reply.

upstream_latency · number

Milliseconds blocked on the upstream socket. Absent when unmeasured.

overhead_latency · number

Bifrost overhead in milliseconds - total minus upstream. Absent when unmeasured.

overhead_breakdown · object[]

Where the overhead was spent, by component.

Show child attributes

cost · number

USD charged to budgets.

cost_per_request · number

cost_per_unit · number

extracted_cost · number

units · number

billed_units · number

input_tokens · integer

output_tokens · integer

total_tokens · integer

job_id · string

job_status · string

parent_log_id · string

On a job row, the id of the start call's log.

user_id · string

user_name · string

virtual_key_id · string

virtual_key_name · string

team_id · string

team_name · string

customer_id · string

customer_name · string

business_unit_id · string

business_unit_name · string

project_id · string

project_name · string

team_ids · string[]

Every team the call was attributed to, when the caller belongs to more than one.

team_names · string[]

customer_ids · string[]

customer_names · string[]

business_unit_ids · string[]

business_unit_names · string[]

user_agent · string

Raw HTTP User-Agent of the calling client.

app · string

Client application detected from user_agent.

request_body · string

response_body · string

plugin_logs · string

JSON-serialized plugin log entries grouped by plugin name.

budget_ids · string[]

rate_limit_ids · string[]

request_headers · object

Show child attributes

response_headers · object

Show child attributes

error_details · object

Error response from Bifrost

Show child attributes