{ "info": { "_postman_id": "f89d7930-a5ef-49e5-8a63-648cda8c823e", "name": "Amigo Account Sessions API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:02:36.000Z", "updatedAt": "2026-07-28T01:02:36.000Z", "lastUpdatedBy": "35240", "uid": "35240-f89d7930-a5ef-49e5-8a63-648cda8c823e" }, "item": [ { "name": "v1", "item": [ { "name": "{workspace_id}", "item": [ { "name": "sessions", "item": [ { "name": "active", "item": [ { "name": "List active voice sessions", "id": "f6455ebe-db44-4a57-b136-6e26a8409d0d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/active", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "active" ], "variable": [ { "id": "0338a9b8-3ce2-42a0-ae2b-ff6f22860513", "key": "workspace_id", "value": "", "description": "(Required) " } ] }, "description": "Real-time list of active voice sessions from Valkey (cross-pod)." }, "response": [ { "id": "a4cf92bd-691e-47b6-bc41-8584aa42936d", "name": "Successful Response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/active", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "active" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"call_sid\": \"\",\n \"caller_id\": \"\",\n \"direction\": \"\",\n \"duration_seconds\": \"\",\n \"service_id\": \"\",\n \"workspace_id\": \"\",\n \"current_state\": \"\",\n \"scenario\": \"\"\n },\n {\n \"call_sid\": \"\",\n \"caller_id\": \"\",\n \"direction\": \"\",\n \"duration_seconds\": \"\",\n \"service_id\": \"\",\n \"workspace_id\": \"\",\n \"current_state\": \"\",\n \"scenario\": \"\"\n }\n]", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-a4cf92bd-691e-47b6-bc41-8584aa42936d" } ], "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-f6455ebe-db44-4a57-b136-6e26a8409d0d" } ], "id": "6da7ddd7-9304-4ab1-9e5d-102ecfc91ade", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-6da7ddd7-9304-4ab1-9e5d-102ecfc91ade" }, { "name": "fleet-status", "item": [ { "name": "Agones fleet capacity status", "id": "98ab5737-ee26-46db-b2c8-a9a43f1ba01a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/fleet-status?fleet=voice", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "fleet-status" ], "query": [ { "key": "fleet", "value": "voice" } ], "variable": [ { "id": "2cb1c758-d6a5-475b-b80e-971b65bac164", "key": "workspace_id", "value": "", "description": "(Required) " } ] }, "description": "Live Agones fleet capacity: Ready/Allocated/total GameServers plus headroom against the maxReplicas ceiling. `fleet=voice` (default) reads the per-call voice fleet; `fleet=tool-runner` reads the isolated background-tool fleet. Workspace-GLOBAL \u2014 one fleet serves every workspace, so the path workspace_id is only the auth anchor, never a data filter. Operator-only." }, "response": [ { "id": "8e6fc0a2-dbcd-4b07-97e9-5f1e77b4d2b9", "name": "Successful Response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/fleet-status?fleet=voice", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "fleet-status" ], "query": [ { "key": "fleet", "value": "voice" } ], "variable": [ { "key": "workspace_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"fleet\": \"\",\n \"namespace\": \"\",\n \"ready\": \"\",\n \"allocated\": \"\",\n \"total\": \"\",\n \"max_replicas\": \"\",\n \"headroom\": \"\",\n \"by_state\": {\n \"dolor_0b1\": \"\",\n \"sedfb\": \"\",\n \"proident93\": \"\"\n }\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-8e6fc0a2-dbcd-4b07-97e9-5f1e77b4d2b9" }, { "id": "1b9ef942-35c4-47ab-adaa-94ed132465de", "name": "Validation Error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/fleet-status?fleet=voice", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "fleet-status" ], "query": [ { "key": "fleet", "value": "voice" } ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-1b9ef942-35c4-47ab-adaa-94ed132465de" } ], "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-98ab5737-ee26-46db-b2c8-a9a43f1ba01a" } ], "id": "990a595c-4df9-435c-bbf9-85540c0f0d29", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-990a595c-4df9-435c-bbf9-85540c0f0d29" }, { "name": "{call_sid}", "item": [ { "name": "inject", "item": [ { "name": "Inject event into active session", "id": "5e9bd4b7-4575-4299-b8b8-73d6aec1ec6e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"sender\": \"System\",\n \"event_type\": \"external_event\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/:call_sid/inject", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", ":call_sid", "inject" ], "variable": [ { "id": "9d158bc8-4142-42ca-ad0e-a8bd378e4ec3", "key": "workspace_id", "value": "", "description": "(Required) " }, { "id": "3c9b6077-552b-4d17-896a-8f64bc19a41a", "key": "call_sid", "value": "", "description": "(Required) " } ] }, "description": "Inject an external event or guidance message into an active voice session. The agent incorporates it into its next response. Use event_type='guidance' for operator coaching, 'external_event' for system notifications." }, "response": [ { "id": "22243d28-8843-4a20-ae22-cd465b51822c", "name": "Successful Response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"sender\": \"System\",\n \"event_type\": \"external_event\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/:call_sid/inject", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", ":call_sid", "inject" ], "variable": [ { "key": "workspace_id" }, { "key": "call_sid" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"queued_no_subscriber\",\n \"call_sid\": \"\"\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-22243d28-8843-4a20-ae22-cd465b51822c" }, { "id": "6cf71dee-07ca-431c-bf3e-eadcd9417f6a", "name": "Session not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"sender\": \"System\",\n \"event_type\": \"external_event\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/:call_sid/inject", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", ":call_sid", "inject" ], "variable": [ { "key": "workspace_id" }, { "key": "call_sid" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-6cf71dee-07ca-431c-bf3e-eadcd9417f6a" }, { "id": "30cb495a-fba2-4c47-80eb-1e7fc7391c22", "name": "Validation Error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"sender\": \"System\",\n \"event_type\": \"external_event\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/:call_sid/inject", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", ":call_sid", "inject" ], "variable": [ { "key": "workspace_id" }, { "key": "call_sid" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-30cb495a-fba2-4c47-80eb-1e7fc7391c22" }, { "id": "96079b6d-8df2-4a63-b1af-0a20c21a8fa6", "name": "Voice agent service unavailable.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"sender\": \"System\",\n \"event_type\": \"external_event\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/:call_sid/inject", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", ":call_sid", "inject" ], "variable": [ { "key": "workspace_id" }, { "key": "call_sid" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-96079b6d-8df2-4a63-b1af-0a20c21a8fa6" } ], "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-5e9bd4b7-4575-4299-b8b8-73d6aec1ec6e" } ], "id": "2192b24c-8bc7-4377-9821-e21e86a8cd0b", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-2192b24c-8bc7-4377-9821-e21e86a8cd0b" } ], "id": "03cfc7a4-fc44-407b-b72e-ab1b446afa8e", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-03cfc7a4-fc44-407b-b72e-ab1b446afa8e" }, { "name": "start", "item": [ { "name": "Start a web text conversation session with an entity", "id": "77a76c8e-fd03-4928-b0db-08698d90f87d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": \"\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"canonical_id\": \"gNBE7W:f7m1xUIiF:1DMKVraM\",\n \"greeting\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/start", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "start" ], "variable": [ { "id": "ed6e70d8-f993-4f07-82cc-1793afae8655", "key": "workspace_id", "value": "", "description": "(Required) " } ] }, "description": "Start a web text session with a world model entity. Materializes the conversation and returns conversation_id for subsequent turns via POST /v1/{ws}/conversations/{id}/turns." }, "response": [ { "id": "ca6d524d-7db4-4334-bfd1-c29189ba5d34", "name": "Successful Response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": \"\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"canonical_id\": \"gNBE7W:f7m1xUIiF:1DMKVraM\",\n \"greeting\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/start", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "start" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"conversation_id\": \"\",\n \"session_status\": \"created\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"service_id\": \"\",\n \"created_at\": \"\"\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-ca6d524d-7db4-4334-bfd1-c29189ba5d34" }, { "id": "88594a2d-5373-4ffb-b3e1-046f22410828", "name": "Service or entity not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": \"\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"canonical_id\": \"gNBE7W:f7m1xUIiF:1DMKVraM\",\n \"greeting\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/start", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "start" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-88594a2d-5373-4ffb-b3e1-046f22410828" }, { "id": "2efbc391-b4b0-4004-a2bf-d4fdf6c5586d", "name": "Validation Error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": \"\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"canonical_id\": \"gNBE7W:f7m1xUIiF:1DMKVraM\",\n \"greeting\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/start", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "start" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-2efbc391-b4b0-4004-a2bf-d4fdf6c5586d" }, { "id": "e53683e6-c989-44c5-b9bb-db094977648e", "name": "Agent service unavailable.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"service_id\": \"\",\n \"channel_kind\": \"\",\n \"entity_id\": \"\",\n \"canonical_id\": \"gNBE7W:f7m1xUIiF:1DMKVraM\",\n \"greeting\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/sessions/start", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "sessions", "start" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-e53683e6-c989-44c5-b9bb-db094977648e" } ], "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-77a76c8e-fd03-4928-b0db-08698d90f87d" } ], "id": "2092658b-8dc0-4f14-9b68-be5bdf1d224a", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-2092658b-8dc0-4f14-9b68-be5bdf1d224a" } ], "id": "f004a608-4faf-486a-8813-cb55cd8b6f1f", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-f004a608-4faf-486a-8813-cb55cd8b6f1f" } ], "id": "44333ace-a644-4041-919f-6f1c8f18bd25", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-44333ace-a644-4041-919f-6f1c8f18bd25" } ], "id": "90f7036a-cdd6-45f6-8f34-db8df10e9a7d", "createdAt": "2026-07-28T01:02:37.000Z", "updatedAt": "2026-07-28T01:02:37.000Z", "uid": "35240-90f7036a-cdd6-45f6-8f34-db8df10e9a7d" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.amigo.ai" } ] }