API referenceLogs, drains and alerts
Get a call log
One call with timings, its redacted request/response body (audit-logged), the other attempts in its routed run or list, and its ledger entries.
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Match
^[A-Za-z0-9_-]{3,128}$Response Body
application/json
application/json
curl -X GET "https://example.com/v1/logs/string"{ "log": { "call_id": "string", "parent_id": "string", "attempt": 0, "workspace_id": "string", "app_id": "string", "app_name": "string", "key_id": "string", "agent_id": "string", "run_id": "string", "supply_mode": "byok", "capability": "string", "endpoint_id": "string", "provider": "string", "mode": "string", "client_mode": "sync", "credential": "managed", "outcome": "hit", "error_code": "string", "http_status": 0, "upstream_status": 0, "total_ms": 0, "overhead_ms": 0, "upstream_ms": 0, "ttfb_ms": 0, "queue_wait_ms": 0, "bytes_in": 0, "bytes_out": 0, "cost_micro": 0, "cache": "hit", "saved_micro": 0, "user_agent": "string", "client_name": "string", "client_version": "string", "client_kind": "sdk", "ip": "string", "asn": 0, "country": "string", "colo": "string", "meta": { "property1": "string", "property2": "string" }, "request_hash": "string", "effective_options": "", "billing_verdict": "ok", "billing_billable": null, "vendor_expected_credits": null, "vendor_reported_credits": null, "vendor_balance_after": null, "vendor_expected_micro": null, "vendor_reported_micro": null, "ts": "2019-08-24T14:15:22Z", "has_body": true }, "body": { "request": { "endpoint_id": "string", "input": null }, "response": { "status": 0, "body": null } }, "body_status": "stored", "attempts": [ { "call_id": "string", "parent_id": "string", "attempt": 0, "workspace_id": "string", "app_id": "string", "app_name": "string", "key_id": "string", "agent_id": "string", "run_id": "string", "supply_mode": "byok", "capability": "string", "endpoint_id": "string", "provider": "string", "mode": "string", "client_mode": "sync", "credential": "managed", "outcome": "hit", "error_code": "string", "http_status": 0, "upstream_status": 0, "total_ms": 0, "overhead_ms": 0, "upstream_ms": 0, "ttfb_ms": 0, "queue_wait_ms": 0, "bytes_in": 0, "bytes_out": 0, "cost_micro": 0, "cache": "hit", "saved_micro": 0, "user_agent": "string", "client_name": "string", "client_version": "string", "client_kind": "sdk", "ip": "string", "asn": 0, "country": "string", "colo": "string", "meta": { "property1": "string", "property2": "string" }, "request_hash": "string", "effective_options": "", "billing_verdict": "ok", "billing_billable": null, "vendor_expected_credits": null, "vendor_reported_credits": null, "vendor_balance_after": null, "vendor_expected_micro": null, "vendor_reported_micro": null, "ts": "2019-08-24T14:15:22Z", "has_body": true } ], "ledger": [ { "seq": 0, "ts": "2019-08-24T14:15:22Z", "kind": "topup", "amount_micro": 0, "balance_after_micro": 0 } ], "hold": { "amount_micro": 0, "charged_micro": 0, "state": "string", "created_at": "2019-08-24T14:15:22Z" }, "billing": null}Call log facets GET
Counts per value (outcome, status, provider, capability, endpoint, key, client…) and latency/cost ranges for the same filters as logs_list.
Search call logs GET
Every call and routed attempt for this org, newest first (360-day retention). Filter by time, outcome, status, provider, capability, endpoint, key, agent, client, mode, credential, error code, latency and cost; cursor-paginated.