{ "info": { "_postman_id": "eaa38817-2dce-4428-96ef-ec018be93f24", "name": "Amigo Account Agent Runs API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "lastUpdatedBy": "35240", "uid": "35240-eaa38817-2dce-4428-96ef-ec018be93f24" }, "item": [ { "name": "v1", "item": [ { "name": "{workspace_id}", "item": [ { "name": "agent-runs", "item": [ { "name": "harness-context", "item": [ { "name": "Fetch the neutral session-bootstrap context for a service", "id": "2f4e8599-88b1-4511-a7c6-a9642f6e611f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/agent-runs/harness-context?service_id=&version_set=release", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", "harness-context" ], "query": [ { "description": "(Required) ", "key": "service_id", "value": "" }, { "key": "version_set", "value": "release" } ], "variable": [ { "id": "e16e0066-becf-4075-acf8-a86c6c5f113d", "key": "workspace_id", "value": "", "description": "(Required) " } ] }, "description": "The retrievable CONTEXT edge of the world-model harness: identity + reference instructions, world scope, tool descriptors, guardrails, and the REAL server-enforced write-floor \u2014 the byte-identical projection the hosted runner renders from, so a customer's own framework can bootstrap a session against the same world model. PHI-free (the API-run projection carries no scoped entities or rendered caller prose)." }, "response": [ { "id": "1557044c-d935-4938-acfa-c3e5ed97b31e", "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/agent-runs/harness-context?service_id=&version_set=release", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", "harness-context" ], "query": [ { "description": "(Required) ", "key": "service_id", "value": "" }, { "key": "version_set", "value": "release" } ], "variable": [ { "key": "workspace_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"world_scope\": {\n \"workspace_id\": \"\",\n \"allow_create\": false\n },\n \"tools\": {},\n \"guardrails\": {},\n \"write_floor\": {\n \"enforced_at\": \"mcp-world-tools-edge\",\n \"requires_entity_anchor\": true,\n \"clinical_write_principal\": \"provider-only\",\n \"clinical_write_scope\": \"any-entity-in-workspace\",\n \"enrichment_write_scope\": \"caller-anchor-only\",\n \"unanchored_or_api_key_writes\": \"none\",\n \"allow_create\": false\n },\n \"runtime\": {\n \"engage_model\": \"\",\n \"channel_kind\": \"\",\n \"language\": \"\",\n \"caller_context\": \"\"\n },\n \"context_version\": 1,\n \"config_fingerprint\": \"\",\n \"source\": \"\",\n \"identity\": {\n \"entry_actor_name\": \"\",\n \"name\": \"\",\n \"role\": \"\",\n \"developed_by\": \"\",\n \"instructions\": \"\",\n \"initial_state\": \"\"\n }\n}", "createdAt": "2026-07-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-1557044c-d935-4938-acfa-c3e5ed97b31e" }, { "id": "6533b8f7-c5d9-4c96-95bc-ba1cad49f4c8", "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/agent-runs/harness-context?service_id=&version_set=release", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", "harness-context" ], "query": [ { "description": "(Required) ", "key": "service_id", "value": "" }, { "key": "version_set", "value": "release" } ], "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-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-6533b8f7-c5d9-4c96-95bc-ba1cad49f4c8" } ], "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-2f4e8599-88b1-4511-a7c6-a9642f6e611f" } ], "id": "3a2911c5-3957-4de6-8f6b-c75bce0895c9", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-3a2911c5-3957-4de6-8f6b-c75bce0895c9" }, { "name": "{run_id}", "item": [ { "name": "Get a framework agent run", "id": "ad92c9bc-5c45-49b2-add7-ea1aba64a359", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/agent-runs/:run_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", ":run_id" ], "variable": [ { "id": "92bdc4f4-cf20-4d04-8109-d40ee26089d1", "key": "workspace_id", "value": "", "description": "(Required) " }, { "id": "f32a2062-3f5c-4c58-9e3d-90471cf14f79", "key": "run_id", "value": "", "description": "(Required) " } ] }, "description": "Run status, final text, token usage, and the adapter-normalized trajectory of the framework's native output." }, "response": [ { "id": "e53dad23-1acb-44c4-9ee1-e63b91bcce3c", "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/agent-runs/:run_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", ":run_id" ], "variable": [ { "key": "workspace_id" }, { "key": "run_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"run_id\": \"\",\n \"status\": \"failed\",\n \"framework\": \"openai-agents\",\n \"text\": \"\",\n \"error\": \"\",\n \"duration_ms\": 0,\n \"usage\": {\n \"input_tokens\": 0,\n \"output_tokens\": 0,\n \"cached_tokens\": 0,\n \"cache_creation_tokens\": 0\n }\n}", "createdAt": "2026-07-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-e53dad23-1acb-44c4-9ee1-e63b91bcce3c" }, { "id": "d3b4e5c7-874d-4584-8108-bb08dc495981", "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/agent-runs/:run_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs", ":run_id" ], "variable": [ { "key": "workspace_id" }, { "key": "run_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-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-d3b4e5c7-874d-4584-8108-bb08dc495981" } ], "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-ad92c9bc-5c45-49b2-add7-ea1aba64a359" } ], "id": "e7945bf6-29ab-4886-8f23-5e0810a9f166", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-e7945bf6-29ab-4886-8f23-5e0810a9f166" }, { "name": "Dispatch a framework agent run", "id": "016c8fc4-0147-4ea1-8a40-2b5ff4e1c8cb", "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 \"service_id\": \"\",\n \"version_set\": \"\",\n \"framework\": \"openai-agents\",\n \"native\": {\n \"definition_id\": \"\",\n \"version\": \"\",\n \"inline\": {\n \"dolor_e0\": \"laborum anim quis ali\",\n \"pariaturc\": \"proident Ut deserunt\",\n \"minim_ae\": \"consectetur fugiat dolor\"\n }\n },\n \"timeout_s\": 120\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/agent-runs", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs" ], "variable": [ { "id": "4675d17f-2b8d-4082-b276-cc094509a467", "key": "workspace_id", "value": "", "description": "(Required) " } ] }, "description": "Proxies to agent-runner, which executes the chosen framework UNMODIFIED (natural setup) against the platform MCP world-tools edge under the caller's own bearer. Non-blocking \u2014 poll GET /agent-runs/{run_id} for the result." }, "response": [ { "id": "6528f967-9150-41c5-b03d-04f611424601", "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 \"service_id\": \"\",\n \"version_set\": \"\",\n \"framework\": \"openai-agents\",\n \"native\": {\n \"definition_id\": \"\",\n \"version\": \"\",\n \"inline\": {\n \"dolor_e0\": \"laborum anim quis ali\",\n \"pariaturc\": \"proident Ut deserunt\",\n \"minim_ae\": \"consectetur fugiat dolor\"\n }\n },\n \"timeout_s\": 120\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/agent-runs", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"run_id\": \"\",\n \"status\": \"\"\n}", "createdAt": "2026-07-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-6528f967-9150-41c5-b03d-04f611424601" }, { "id": "878533cd-df5f-49fd-8163-8c05f119465a", "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 \"service_id\": \"\",\n \"version_set\": \"\",\n \"framework\": \"openai-agents\",\n \"native\": {\n \"definition_id\": \"\",\n \"version\": \"\",\n \"inline\": {\n \"dolor_e0\": \"laborum anim quis ali\",\n \"pariaturc\": \"proident Ut deserunt\",\n \"minim_ae\": \"consectetur fugiat dolor\"\n }\n },\n \"timeout_s\": 120\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/agent-runs", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "agent-runs" ], "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-28T00:59:45.000Z", "updatedAt": "2026-07-28T00:59:45.000Z", "uid": "35240-878533cd-df5f-49fd-8163-8c05f119465a" } ], "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-016c8fc4-0147-4ea1-8a40-2b5ff4e1c8cb" } ], "id": "1c2951df-1e5a-4df0-beb8-7d30a4253253", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-1c2951df-1e5a-4df0-beb8-7d30a4253253" } ], "id": "d1aeb9d5-fb07-485f-b919-669494b46f0d", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-d1aeb9d5-fb07-485f-b919-669494b46f0d" } ], "id": "1ba5ca31-2b15-4e5d-8234-49bd6934badf", "createdAt": "2026-07-28T00:59:44.000Z", "updatedAt": "2026-07-28T00:59:44.000Z", "uid": "35240-1ba5ca31-2b15-4e5d-8234-49bd6934badf" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.amigo.ai" } ] }