Get a single log entry

Retrieves a single log entry by its ID.

GET /api/logs/{id}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>",
  "project_id": "<string>",
  "project_name": "<string>",
  "parent_request_id": "<string>",
  "provider": "<string>",
  "model": "<string>",
  "status": "processing",
  "object": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "number_of_retries": 123,
  "fallback_index": 123,
  "latency": 123,
  "cost": 123,
  "selected_key_id": "<string>",
  "selected_key_name": "<string>",
  "virtual_key_id": "<string>",
  "virtual_key_name": "<string>",
  "routing_engines_used": [
    "<string>"
  ],
  "tool_call_names": [
    "<string>"
  ],
  "routing_rule_id": "<string>",
  "routing_rule_name": "<string>",
  "complexity_tier": "SIMPLE",
  "complexity_mechanism": "semantic",
  "complexity_score": 123,
  "session_id": "<string>",
  "child_count": 123,
  "children_cost": 123,
  "children_tokens": 123,
  "session_child_count": 123,
  "session_total_cost": 123,
  "session_total_tokens": 123,
  "stream": true,
  "raw_request": "<string>",
  "raw_response": "<string>",
  "redaction_mapping": {
    "input": {},
    "output": {}
  },
  "created_at": "2023-11-07T05:31:56Z",
  "token_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
    }
  },
  "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": {
      "provider": "anthropic",
      "model_requested": "<string>",
      "request_type": "<string>",
      "error_type": "<string>",
      "retry_after_ms": 150500
    }
  },
  "input_history": [
    {
      "role": "assistant",
      "name": "<string>",
      "content": "<string>",
      "tool_call_id": "<string>",
      "refusal": "<string>",
      "audio": {
        "id": "<string>",
        "data": "<string>",
        "expires_at": 123,
        "transcript": "<string>"
      },
      "reasoning": "<string>",
      "reasoning_details": [
        {
          "id": "<string>",
          "index": 123,
          "type": "reasoning.summary",
          "summary": "<string>",
          "text": "<string>",
          "signature": "<string>",
          "data": "<string>"
        }
      ],
      "annotations": [
        {
          "type": "<string>",
          "url_citation": {
            "start_index": 123,
            "end_index": 123,
            "title": "<string>",
            "url": "<string>",
            "sources": {},
            "type": "<string>"
          }
        }
      ],
      "tool_calls": [
        {
          "function": {
            "name": "<string>",
            "arguments": "<string>"
          },
          "index": 123,
          "type": "<string>",
          "id": "<string>",
          "cache_control": {
            "type": "ephemeral",
            "ttl": "<string>"
          }
        }
      ]
    }
  ],
  "responses_input_history": [
    {
      "id": "<string>",
      "type": "message",
      "status": "in_progress",
      "role": "assistant",
      "content": "<string>",
      "call_id": "<string>",
      "name": "<string>",
      "arguments": "<string>",
      "output": "<string>",
      "async": true,
      "action": {},
      "error": "<string>",
      "queries": [
        "<string>"
      ],
      "results": [
        {}
      ],
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>"
    }
  ],
  "output_message": {
    "role": "assistant",
    "name": "<string>",
    "content": "<string>",
    "tool_call_id": "<string>",
    "refusal": "<string>",
    "audio": {
      "id": "<string>",
      "data": "<string>",
      "expires_at": 123,
      "transcript": "<string>"
    },
    "reasoning": "<string>",
    "reasoning_details": [
      {
        "id": "<string>",
        "index": 123,
        "type": "reasoning.summary",
        "summary": "<string>",
        "text": "<string>",
        "signature": "<string>",
        "data": "<string>"
      }
    ],
    "annotations": [
      {
        "type": "<string>",
        "url_citation": {
          "start_index": 123,
          "end_index": 123,
          "title": "<string>",
          "url": "<string>",
          "sources": {},
          "type": "<string>"
        }
      }
    ],
    "tool_calls": [
      {
        "function": {
          "name": "<string>",
          "arguments": "<string>"
        },
        "index": 123,
        "type": "<string>",
        "id": "<string>",
        "cache_control": {
          "type": "ephemeral",
          "ttl": "<string>"
        }
      }
    ]
  },
  "responses_output": [
    {
      "id": "<string>",
      "type": "message",
      "status": "in_progress",
      "role": "assistant",
      "content": "<string>",
      "call_id": "<string>",
      "name": "<string>",
      "arguments": "<string>",
      "output": "<string>",
      "async": true,
      "action": {},
      "error": "<string>",
      "queries": [
        "<string>"
      ],
      "results": [
        {}
      ],
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>"
    }
  ],
  "embedding_output": [
    [
      123
    ]
  ],
  "params": {},
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "<string>",
        "description": "<string>",
        "parameters": {
          "type": "<string>",
          "description": "<string>",
          "required": [
            "<string>"
          ],
          "properties": {},
          "enum": [
            "<string>"
          ],
          "additionalProperties": true
        },
        "strict": true
      },
      "custom": {
        "format": {
          "type": "<string>",
          "grammar": {
            "definition": "<string>",
            "syntax": "lark"
          }
        }
      },
      "cache_control": {
        "type": "ephemeral",
        "ttl": "<string>"
      }
    }
  ],
  "tool_calls": [
    {
      "function": {
        "name": "<string>",
        "arguments": "<string>"
      },
      "index": 123,
      "type": "<string>",
      "id": "<string>"
    }
  ],
  "speech_input": {},
  "transcription_input": {},
  "image_generation_input": {},
  "speech_output": {},
  "transcription_output": {},
  "image_generation_output": {},
  "cache_debug": {},
  "metadata": {},
  "selected_key": {},
  "virtual_key": {},
  "passthrough_request_body": "<string>",
  "passthrough_response_body": "<string>",
  "routing_engine_logs": {},
  "is_large_payload_request": true,
  "is_large_payload_response": true,
  "rerank_output": {},
  "video_generation_input": {},
  "video_generation_output": {},
  "video_retrieve_output": {},
  "video_list_output": {},
  "video_delete_output": {},
  "video_download_output": {},
  "list_models_output": {}
}

Required Permissions

Permission	Granted via
Logs: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

Log entry ID

Response

200

application/json

Successful response

Log entry

id · string

project_id · string | null

The governance project the request was scoped to, or null when it named none. This is the resolved project, not the header the caller sent.

project_name · string | null

The project's name as it stood when the request was served, kept on the row so it still reads correctly after a rename or a delete.

parent_request_id · string

provider · string

model · string

status · enum<string>

Available options: processing, success, error

object · string

timestamp · string<date-time>

number_of_retries · integer

fallback_index · integer

latency · number

cost · number

selected_key_id · string

selected_key_name · string

virtual_key_id · string

virtual_key_name · string | null

routing_engines_used · string[]

Array of routing engines used for this request (routing-rule, governance, or loadbalancing)

tool_call_names · string[] | null

Distinct function names the response called. Always recorded, even when content logging is disabled, and kept on the log row in hybrid storage mode. Use the tool_call_names query filter to search on it. Full tool calls with arguments are in tool_calls and are available only when content is retained.

routing_rule_id · string | null

routing_rule_name · string | null

complexity_tier · enum<string> | null

Complexity tier used for routing; null when no routing rule referenced complexity_tier. REASONING is historical-only — it was merged into COMPLEX and is never emitted for new requests, but survives in log rows recorded under the old scheme.

Available options: SIMPLE, MEDIUM, COMPLEX, REASONING

complexity_mechanism · enum<string> | null

How the effective complexity tier was determined. decision means the configured decision model supplied the tier; session means retained session state supplied it; skipped means classification was demanded but produced no tier.

Available options: semantic, decision, llm, session, skipped, null

complexity_score · number | null

Similarity score of the nearest reference phrase behind the tier. Absent for decision-model, LLM, session, and skipped decisions.

session_id · string | null

Raw opaque Bifrost session ID resolved at ingress for key stickiness and request correlation.

child_count · integer

Rows nesting under this one (fallback attempts, and settled async cost rows). Present only on roots_only responses.

children_cost · number

Cost summed over those nested rows, under the same filters as the listing. Present only on roots_only responses.

children_tokens · integer

Tokens summed over those nested rows, under the same filters as the listing. Present only on roots_only responses.

session_child_count · integer

Rows in this session other than this one. Present only on the root of a collapsed session (group_sessions responses), and absent for a session with a single matching row.

session_total_cost · number

Cost summed over the whole session, this row included, under the same filters as the listing. Present only on the root of a collapsed session (group_sessions responses), and absent for a session with a single matching row or when the total is zero.

session_total_tokens · integer

Tokens summed over the whole session, this row included, under the same filters as the listing. Present only on the root of a collapsed session (group_sessions responses), and absent for a session with a single matching row or when the total is zero.

stream · boolean

raw_request · string

raw_response · string

redaction_mapping · object

Phase-scoped placeholder-to-original-value mappings for reversible redactions. Present only on log detail responses when the caller has Logs:Reveal.

Show child attributes

created_at · string<date-time>

token_usage · object

Token usage information

Show child attributes

error_details · object

Error response from Bifrost

Show child attributes

input_history · object[]

Show child attributes

responses_input_history · object[]

Show child attributes

output_message · object

Show child attributes

responses_output · object[]

Show child attributes

embedding_output · number[][]

params · object

tools · object[]

Show child attributes

tool_calls · object[]

Show child attributes

speech_input · object

transcription_input · object

image_generation_input · object

speech_output · object

transcription_output · object

image_generation_output · object

cache_debug · object

metadata · object

Custom metadata captured from request headers (configured via logging_headers or x-bf-lh-* prefix)

selected_key · object

virtual_key · object

passthrough_request_body · string

Raw passthrough request body (for passthrough integration routes)

passthrough_response_body · string

Raw passthrough response body (for passthrough integration routes)

routing_engine_logs · object

Detailed logs from the routing engine decision process

is_large_payload_request · boolean

Whether the request payload exceeded the large payload threshold

is_large_payload_response · boolean

Whether the response payload exceeded the large payload threshold

rerank_output · object

Rerank operation output

video_generation_input · object

Video generation request input

video_generation_output · object

Video generation response output

video_retrieve_output · object

Video retrieve response output

video_list_output · object

Video list response output

video_delete_output · object

Video delete response output

video_download_output · object

Video download response output

list_models_output · object

List models response output