Get relay logs

Error

A valid request URL is required to generate request examples

{
  "logs": [
    {
      "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
            }
          }
        }
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "sort_by": "timestamp",
    "order": "asc",
    "total_count": 123
  },
  "has_logs": true
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

GET

api

relay-logs

Error

A valid request URL is required to generate request examples

{
  "logs": [
    {
      "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
            }
          }
        }
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "sort_by": "timestamp",
    "order": "asc",
    "total_count": 123
  },
  "has_logs": true
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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
      }
    }
  }
}

{
  "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

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.

Query Parameters

relay_names

string

Relay names to filter by. Accepts repeated parameters or comma-separated values.

methods

string

HTTP methods to filter by. Accepts repeated parameters or comma-separated values.

statuses

string

Statuses to filter by (success, error, cancelled). Accepts repeated parameters or comma-separated values.

kinds

string

Row kinds to filter by (call, job). Accepts repeated parameters or comma-separated values.

virtual_key_ids

string

Virtual key IDs to filter by. Accepts repeated parameters or comma-separated values.

user_ids

string

User IDs to filter by. Accepts repeated parameters or comma-separated values.

team_ids

string

Team IDs to filter by. Accepts repeated parameters or comma-separated values.

customer_ids

string

Customer IDs to filter by. Accepts repeated parameters or comma-separated values.

business_unit_ids

string

Business unit IDs to filter by. Accepts repeated parameters or comma-separated values.

project_ids

string

Project IDs to filter by. Accepts repeated parameters or comma-separated values.

apps

string

Client applications (as detected from the User-Agent) to filter by. Accepts repeated parameters or comma-separated values.

billable

boolean

Keep only billable (true) or non-billable (false) calls.

start_time

string<date-time>

Start of the time range (RFC3339).

end_time

string<date-time>

End of the time range (RFC3339).

min_cost

number

Minimum cost in USD.

max_cost

number

Maximum cost in USD.

request_id

string

Exact request ID.

job_id

string

Exact upstream job ID.

string

Free-text match on the path, matched route, model and request ID. Metadata columns only, never bodies.

limit

integer

default:50

Number of rows to return (default 50, max 1000)

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of rows to skip

Required range: x >= 0

sort_by

enum<string>

default:timestamp

Field to sort by. Unknown values fall back to timestamp.

Available options:

timestamp,

latency,

cost

order

enum<string>

default:desc

Sort order. Anything other than asc sorts descending.

Available options:

asc,

desc

Response

One page of relay logs

logs

object[]

required

Show child attributes

pagination

object

required

Pagination metadata of a Relay Logs page. Relay logs sort by timestamp, latency or cost only.

Show child attributes

has_logs

boolean

required

Whether any relay log exists at all, so an empty page can be told from an empty store.

Authentication

Inference

Integrations

Platform

Governance

Routing

Deprecated

Authorizations

Query Parameters

Response