{"info":{"_postman_id":"b73c9ab8-e1f6-4b28-a50e-cb5201b951a5","name":"AI Agent Management API","description":"

API to create, update, retrieve, and delete AI agents as containers.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11917400","collectionId":"b73c9ab8-e1f6-4b28-a50e-cb5201b951a5","publishedId":"2sAYX6phJN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-02-05T21:15:20.000Z"},"item":[{"name":"agents","item":[{"name":"{chainId}/{address}","item":[{"name":"Get details of a specific AI Agent","id":"1759492d-a844-4f60-92d4-2397100a1579","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"http://localhost:4444/agents/:chainId/:address","urlObject":{"path":["agents",":chainId",":address"],"host":["http://localhost:4444"],"query":[],"variable":[{"id":"bfd9fd82-b6f2-432e-8d40-7d38892ff961","description":{"content":"

(Required) The chain ID associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"chainId"},{"id":"17e17d13-6ea2-4fba-9ebb-19b9efce49d2","description":{"content":"

(Required) The address associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"address"}]}},"response":[{"id":"7d08bf24-f1fd-4b6c-8955-a25bcf523974","name":"Successful response with agent details.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n },\n \"agent\": {\n \"id\": \"\",\n \"status\": \"\",\n \"port\": \"\",\n \"createdAt\": \"\",\n \"state\": \"\"\n }\n }\n}"},{"id":"b7a01201-4fb7-4d3d-b26b-515e63d74494","name":"Agent not found or invalid parameters.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"}],"_postman_id":"1759492d-a844-4f60-92d4-2397100a1579"},{"name":"Update AI Agent configuration","id":"f2b9bd95-8eef-49de-9647-8a718d050e6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4444/agents/:chainId/:address","urlObject":{"path":["agents",":chainId",":address"],"host":["http://localhost:4444"],"query":[],"variable":[{"id":"1fadcc53-f4ba-461f-b283-90335e45470a","description":{"content":"

(Required) The chain ID associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"chainId"},{"id":"25936285-ce9e-4f1f-b0bc-d11f22382b6d","description":{"content":"

(Required) The address associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"address"}]}},"response":[{"id":"92d345db-c2b8-4ffb-9efa-389e09c96f85","name":"Agent updated successfully.","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"\",\n \"id\": \"\"\n}"},{"id":"46f23858-7715-4826-8b54-28e96ba506cd","name":"Validation error or container not found.","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"}],"_postman_id":"f2b9bd95-8eef-49de-9647-8a718d050e6a"},{"name":"Delete an AI Agent","id":"bd84112a-2a28-40fe-acda-4689c01fe4cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":"http://localhost:4444/agents/:chainId/:address","urlObject":{"path":["agents",":chainId",":address"],"host":["http://localhost:4444"],"query":[],"variable":[{"id":"0e18669f-69cc-4290-b3fa-a1f4486024a4","description":{"content":"

(Required) The chain ID associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"chainId"},{"id":"fee19d88-48a1-4678-9f56-39855eef91cc","description":{"content":"

(Required) The address associated with the agent.

\n","type":"text/plain"},"type":"any","value":"","key":"address"}]}},"response":[{"id":"dfe823ff-2b2d-4d2b-b958-ecb63a525f57","name":"Agent successfully deleted.","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"\",\n \"id\": \"\"\n}"},{"id":"29618c41-eaae-44ed-afba-9311cccfef50","name":"Agent does not exist.","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"},{"id":"6d81d516-a6b4-41f7-bec5-d5c8c0c676f7","name":"Failed to delete agent.","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"http://localhost:4444/agents/:chainId/:address","host":["http://localhost:4444"],"path":["agents",":chainId",":address"],"variable":[{"key":"chainId","value":"","description":"(Required) The chain ID associated with the agent."},{"key":"address","value":"","description":"(Required) The address associated with the agent."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"}],"_postman_id":"bd84112a-2a28-40fe-acda-4689c01fe4cf"}],"id":"6bfa3c83-6e8d-41e6-9528-d642be67eddc","_postman_id":"6bfa3c83-6e8d-41e6-9528-d642be67eddc","description":""},{"name":"List all AI agents","id":"e2064c2c-98f8-47a3-9e80-da321ce5b85f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"http://localhost:4444/agents","urlObject":{"path":["agents"],"host":["http://localhost:4444"],"query":[],"variable":[]}},"response":[{"id":"24ee78da-071b-4760-aac8-e50ee25910f6","name":"Successful response with the agents' details.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"http://localhost:4444/agents"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n },\n \"agent\": {\n \"id\": \"\",\n \"status\": \"\",\n \"port\": \"\",\n \"createdAt\": \"\",\n \"state\": \"\"\n }\n },\n {\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n },\n \"agent\": {\n \"id\": \"\",\n \"status\": \"\",\n \"port\": \"\",\n \"createdAt\": \"\",\n \"state\": \"\"\n }\n }\n ]\n}"},{"id":"f933d420-506d-464e-aecb-d6f7132b3e96","name":"Error retrieving agents.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"http://localhost:4444/agents"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"}],"_postman_id":"e2064c2c-98f8-47a3-9e80-da321ce5b85f"},{"name":"Create a new AI Agent","id":"a714e4bc-ac71-4c59-9999-edab87d54e63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4444/agents","urlObject":{"path":["agents"],"host":["http://localhost:4444"],"query":[],"variable":[]}},"response":[{"id":"f25d7fbf-de37-41d8-9c09-f30155b0e1c4","name":"Agent created successfully.","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4444/agents"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"\",\n \"id\": \"\"\n}"},{"id":"4076a075-9640-4286-918b-5fbfc451f7f8","name":"Validation error.","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4444/agents"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"},{"id":"bdd5c77f-77ad-4d6b-b0c1-59796cdd781f","name":"Failed to create agent.","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"character\": \"\",\n \"contract\": {\n \"name\": \"\",\n \"address\": \"\",\n \"chainId\": \"\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4444/agents"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"\"\n}"}],"_postman_id":"a714e4bc-ac71-4c59-9999-edab87d54e63"}],"id":"88dceac8-9ff9-4701-b70e-e71742ce0414","_postman_id":"88dceac8-9ff9-4701-b70e-e71742ce0414","description":""}],"variable":[{"key":"baseUrl","value":"http://localhost:4444","type":"string"}]}