{ "info": { "_postman_id": "f0e16253-b81c-4ac8-8f4f-0a57a23f6fe9", "name": "Waxell Observe Cost Management Governance API", "description": "The Waxell Observe REST API exposes the AI agent governance and\nobservability control plane. It is used by the `waxell-observe` Python\nSDK and Developer MCP server to record agent runs, log LLM calls and\nspans, evaluate runtime governance policies, manage prompts, and\nadminister model cost tables.\n\nEndpoints are served from a tenant-specific control plane host\n(e.g. `https://acme.waxell.dev`) at the path prefix\n`/api/v1/observe/`. Authentication uses the same `wax_sk_` keys\nissued in the dashboard, presented either as `X-Wax-Key` or as a\n`Bearer` token.\n\n\nContact Support:\n Name: Waxell", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:29:10.000Z", "updatedAt": "2026-07-28T03:29:10.000Z", "lastUpdatedBy": "35240", "uid": "35240-f0e16253-b81c-4ac8-8f4f-0a57a23f6fe9" }, "item": [ { "name": "api", "item": [ { "name": "v1", "item": [ { "name": "observe", "item": [ { "name": "policy-check", "item": [ { "name": "Check Policy", "id": "9d915568-fc2b-484f-a4d7-ee1515122bdf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"agent_name\": \"\",\n \"action\": \"\",\n \"run_id\": \"\",\n \"context\": {\n \"quisa\": 29665355,\n \"dolor1d2\": -47095147.51649149\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/observe/policy-check/", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "observe", "policy-check", "" ] }, "description": "Evaluate the configured governance policies for a proposed agent\naction. The response indicates whether to allow, warn, redact,\nthrottle, block, skip, or retry the action.\n" }, "response": [ { "id": "8f3fccd6-cade-4060-893a-7219ca8407d7", "name": "Decision returned", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Wax-Key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"agent_name\": \"\",\n \"action\": \"\",\n \"run_id\": \"\",\n \"context\": {\n \"quisa\": 29665355,\n \"dolor1d2\": -47095147.51649149\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/observe/policy-check/", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "observe", "policy-check", "" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"decision\": \"allow\",\n \"policy_id\": \"\",\n \"category\": \"\",\n \"reason\": \"\",\n \"retry_after_seconds\": \"\",\n \"redacted_content\": \"\"\n}", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-8f3fccd6-cade-4060-893a-7219ca8407d7" }, { "id": "eba64143-9a55-4aeb-95d0-c0d4146c103a", "name": "Rate limit or governance throttle triggered.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Wax-Key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"agent_name\": \"\",\n \"action\": \"\",\n \"run_id\": \"\",\n \"context\": {\n \"quisa\": 29665355,\n \"dolor1d2\": -47095147.51649149\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/observe/policy-check/", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "observe", "policy-check", "" ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"request_id\": \"\"\n}", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-eba64143-9a55-4aeb-95d0-c0d4146c103a" } ], "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-9d915568-fc2b-484f-a4d7-ee1515122bdf" } ], "id": "bfa7af14-bdeb-44c5-a6c1-d2e16292a910", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-bfa7af14-bdeb-44c5-a6c1-d2e16292a910" }, { "name": "events", "item": [ { "name": "Record Event", "id": "96bf299c-0448-4cf2-b2d6-2cd52947ab05", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"agent_name\": \"\",\n \"run_id\": \"\",\n \"severity\": \"error\",\n \"attributes\": {\n \"laborum_e7f\": -56640442,\n \"esse_76\": \"proident amet sint laborum\",\n \"officia5\": 21778125\n },\n \"created_at\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/observe/events/", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "observe", "events", "" ] }, "description": "Append a governance or audit event to the immutable audit trail." }, "response": [ { "id": "a39cca37-8c15-4542-bfbf-7d889db8289f", "name": "Event recorded", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Wax-Key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"agent_name\": \"\",\n \"run_id\": \"\",\n \"severity\": \"error\",\n \"attributes\": {\n \"laborum_e7f\": -56640442,\n \"esse_76\": \"proident amet sint laborum\",\n \"officia5\": 21778125\n },\n \"created_at\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/observe/events/", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "observe", "events", "" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"agent_name\": \"\",\n \"run_id\": \"\",\n \"severity\": \"error\",\n \"attributes\": {\n \"laborum_e7f\": -56640442,\n \"esse_76\": \"proident amet sint laborum\",\n \"officia5\": 21778125\n },\n \"created_at\": \"\"\n}", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-a39cca37-8c15-4542-bfbf-7d889db8289f" } ], "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-96bf299c-0448-4cf2-b2d6-2cd52947ab05" } ], "id": "cea76694-bc8c-4ab2-8fac-e5d08b083340", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-cea76694-bc8c-4ab2-8fac-e5d08b083340" } ], "id": "6bd0853b-2988-42d1-9143-c531a4a9fc73", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-6bd0853b-2988-42d1-9143-c531a4a9fc73" } ], "id": "e6c2ccec-5290-4fb2-8af2-978a0db188c8", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-e6c2ccec-5290-4fb2-8af2-978a0db188c8" } ], "id": "7357fbd6-0525-447f-9467-db1bd5e79289", "createdAt": "2026-07-28T03:29:11.000Z", "updatedAt": "2026-07-28T03:29:11.000Z", "uid": "35240-7357fbd6-0525-447f-9467-db1bd5e79289" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Wax-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "tenant", "value": "acme" }, { "key": "baseUrl", "value": "https://{{tenant}}.waxell.dev" } ] }