207:I[101443,["https://app.buildwithfern.com/_next/static/immutable/chunks/0xmgppy6c_mh8.js","https://app.buildwithfern.com/_next/static/immutable/chunks/230d0ta35d95a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1fu5zu3p0kax4.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3h8wc6jlok0kt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2keyjoxe_xpyt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0o_h6ac3pa-9q.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0x59_mzmzmxy6.js","https://app.buildwithfern.com/_next/static/immutable/chunks/03w70glgr4690.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3kddk--7sseol.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1keb3ycmkfwgt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31s2f1csvea5a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1cue2ugdfepfm.js","https://app.buildwithfern.com/_next/static/immutable/chunks/14gxuylmt2jhv.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1mhmig4b1nvft.js","https://app.buildwithfern.com/_next/static/immutable/chunks/04c22f6nktp2g.js","https://app.buildwithfern.com/_next/static/immutable/chunks/238davtl8og_7.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2mjo6z0-su8u9.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3p9tk099xipyj.js","https://app.buildwithfern.com/_next/static/immutable/chunks/19xybe_p57542.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0esapfjuyc4yz.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1366d9n7dkhd2.js","https://app.buildwithfern.com/_next/static/immutable/chunks/02dgkrr20pus_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3pv4qy5i1r4hf.js","https://app.buildwithfern.com/_next/static/immutable/chunks/42izzc1yovais.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0xmj3tesniy-f.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1r8x8gbl6axdq.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31u8ypko2q4if.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0gthmetvenq4_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1-ci3nexq_zpt.js"],"ApiDefinitionIdProvider"] 208:I[458315,["https://app.buildwithfern.com/_next/static/immutable/chunks/0xmgppy6c_mh8.js","https://app.buildwithfern.com/_next/static/immutable/chunks/230d0ta35d95a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1fu5zu3p0kax4.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3h8wc6jlok0kt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2keyjoxe_xpyt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0o_h6ac3pa-9q.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0x59_mzmzmxy6.js","https://app.buildwithfern.com/_next/static/immutable/chunks/03w70glgr4690.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3kddk--7sseol.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1keb3ycmkfwgt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31s2f1csvea5a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1cue2ugdfepfm.js","https://app.buildwithfern.com/_next/static/immutable/chunks/14gxuylmt2jhv.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1mhmig4b1nvft.js","https://app.buildwithfern.com/_next/static/immutable/chunks/04c22f6nktp2g.js","https://app.buildwithfern.com/_next/static/immutable/chunks/238davtl8og_7.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2mjo6z0-su8u9.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3p9tk099xipyj.js","https://app.buildwithfern.com/_next/static/immutable/chunks/19xybe_p57542.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0esapfjuyc4yz.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1366d9n7dkhd2.js","https://app.buildwithfern.com/_next/static/immutable/chunks/02dgkrr20pus_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3pv4qy5i1r4hf.js","https://app.buildwithfern.com/_next/static/immutable/chunks/42izzc1yovais.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0xmj3tesniy-f.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1r8x8gbl6axdq.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31u8ypko2q4if.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0gthmetvenq4_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1-ci3nexq_zpt.js"],"PrefetchDynamicIR"] 209:I[771182,["https://app.buildwithfern.com/_next/static/immutable/chunks/0xmgppy6c_mh8.js","https://app.buildwithfern.com/_next/static/immutable/chunks/230d0ta35d95a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1fu5zu3p0kax4.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3h8wc6jlok0kt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2keyjoxe_xpyt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0o_h6ac3pa-9q.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0x59_mzmzmxy6.js","https://app.buildwithfern.com/_next/static/immutable/chunks/03w70glgr4690.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3kddk--7sseol.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1keb3ycmkfwgt.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31s2f1csvea5a.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1cue2ugdfepfm.js","https://app.buildwithfern.com/_next/static/immutable/chunks/14gxuylmt2jhv.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1mhmig4b1nvft.js","https://app.buildwithfern.com/_next/static/immutable/chunks/04c22f6nktp2g.js","https://app.buildwithfern.com/_next/static/immutable/chunks/238davtl8og_7.js","https://app.buildwithfern.com/_next/static/immutable/chunks/2mjo6z0-su8u9.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3p9tk099xipyj.js","https://app.buildwithfern.com/_next/static/immutable/chunks/19xybe_p57542.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0esapfjuyc4yz.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1366d9n7dkhd2.js","https://app.buildwithfern.com/_next/static/immutable/chunks/02dgkrr20pus_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/3pv4qy5i1r4hf.js","https://app.buildwithfern.com/_next/static/immutable/chunks/42izzc1yovais.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0xmj3tesniy-f.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1r8x8gbl6axdq.js","https://app.buildwithfern.com/_next/static/immutable/chunks/31u8ypko2q4if.js","https://app.buildwithfern.com/_next/static/immutable/chunks/0gthmetvenq4_.js","https://app.buildwithfern.com/_next/static/immutable/chunks/1-ci3nexq_zpt.js"],"LazyExplorerRenderer"] 20b:I[637822,["https://app.buildwithfern.com/_next/static/immutable/chunks/0xmgppy6c_mh8.js"],"IconMark"] 76:["$","$L207",null,{"value":"8032d34b-0da4-5b39-9317-556392035285","children":[["$","$L208",null,{"apiDefinitionId":"8032d34b-0da4-5b39-9317-556392035285"}],["$","$L209",null,{"type":"endpoint","context":{"node":{"type":"endpoint","id":"api-leaf:api-reference/api-reference/agent-messages/messages-agents","title":"Messages agents","slug":"api-reference/api-reference/agent-messages/messages-agents","icon":"$undefined","hidden":false,"authed":"$undefined","orphaned":"$undefined","canonicalSlug":"$undefined","collapsed":"$undefined","viewers":"$undefined","featureFlags":"$undefined","method":"POST","endpointId":"endpoint_agentMessages.messagesAgents","apiDefinitionId":"8032d34b-0da4-5b39-9317-556392035285","isResponseStream":false,"availability":"$undefined","playground":"$undefined"},"endpoint":{"id":"endpoint_agentMessages.messagesAgents","namespace":["subpackage_agentMessages"],"displayName":"Messages agents","operationId":"messagesAgents","method":"POST","path":[{"type":"literal","value":"/agents/"},{"type":"pathParameter","value":"id"},{"type":"literal","value":"/messages"}],"auth":["BearerAuth"],"multiAuth":[{"schemes":["BearerAuth"]}],"defaultEnvironment":"Production","environments":[{"baseUrl":"https://api.recursiv.io/api/v1","id":"Production"}],"pathParameters":[{"key":"id","valueShape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}},"description":"$undefined","arguments":"$undefined"}],"requests":[],"responses":[{"description":"Success","statusCode":200,"body":{"type":"alias","value":{"type":"id","id":"Agent Messages_messagesAgents_Response_200"}}}],"errors":[{"description":"Missing or invalid API key","name":"Unauthorized Error","statusCode":401,"shape":{"type":"alias","value":{"type":"unknown"}},"examples":[],"headers":"$undefined"},{"description":"Requires scope: agents:write","name":"Forbidden Error","statusCode":403,"shape":{"type":"alias","value":{"type":"id","id":"MessagesAgentsRequestForbiddenError"}},"examples":[],"headers":"$undefined"}],"examples":[{"path":"/agents/id/messages","responseStatusCode":200,"description":"","pathParameters":{"id":"id"},"queryParameters":{},"headers":{},"responseBody":{"type":"json","value":{}},"snippets":{"curl":[{"language":"curl","code":"curl -X POST https://api.recursiv.io/api/v1/agents/id/messages \\\n -H \"Authorization: Bearer \"","generated":true,"description":"$undefined"}],"python":[{"name":"$undefined","language":"python","install":"$undefined","code":"import requests\n\nurl = \"https://api.recursiv.io/api/v1/agents/id/messages\"\n\nresponse = requests.post(url)\n\nprint(response.json())","generated":true,"description":"$undefined"}],"javascript":[{"name":"$undefined","language":"javascript","install":"$undefined","code":"const url = 'https://api.recursiv.io/api/v1/agents/id/messages';\nconst options = {method: 'POST'};\n\ntry {\n const response = await fetch(url, options);\n const data = await response.json();\n console.log(data);\n} catch (error) {\n console.error(error);\n}","generated":true,"description":"$undefined"}],"go":[{"name":"$undefined","language":"go","install":"$undefined","code":"package main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"io\"\n)\n\nfunc main() {\n\n\turl := \"https://api.recursiv.io/api/v1/agents/id/messages\"\n\n\treq, _ := http.NewRequest(\"POST\", url, nil)\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := io.ReadAll(res.Body)\n\n\tfmt.Println(res)\n\tfmt.Println(string(body))\n\n}","generated":true,"description":"$undefined"}],"ruby":[{"name":"$undefined","language":"ruby","install":"$undefined","code":"require 'uri'\nrequire 'net/http'\n\nurl = URI(\"https://api.recursiv.io/api/v1/agents/id/messages\")\n\nhttp = Net::HTTP.new(url.host, url.port)\nhttp.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\n\nresponse = http.request(request)\nputs response.read_body","generated":true,"description":"$undefined"}],"java":[{"name":"$undefined","language":"java","install":"$undefined","code":"import com.mashape.unirest.http.HttpResponse;\nimport com.mashape.unirest.http.Unirest;\n\nHttpResponse response = Unirest.post(\"https://api.recursiv.io/api/v1/agents/id/messages\")\n .asString();","generated":true,"description":"$undefined"}],"php":[{"name":"$undefined","language":"php","install":"$undefined","code":"request('POST', 'https://api.recursiv.io/api/v1/agents/id/messages');\n\necho $response->getBody();","generated":true,"description":"$undefined"}],"csharp":[{"name":"$undefined","language":"csharp","install":"$undefined","code":"using RestSharp;\n\nvar client = new RestClient(\"https://api.recursiv.io/api/v1/agents/id/messages\");\nvar request = new RestRequest(Method.POST);\nIRestResponse response = client.Execute(request);","generated":true,"description":"$undefined"}],"swift":[{"name":"$undefined","language":"swift","install":"$undefined","code":"import Foundation\n\nlet request = NSMutableURLRequest(url: NSURL(string: \"https://api.recursiv.io/api/v1/agents/id/messages\")! as URL,\n cachePolicy: .useProtocolCachePolicy,\n timeoutInterval: 10.0)\nrequest.httpMethod = \"POST\"\n\nlet session = URLSession.shared\nlet dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in\n if (error != nil) {\n print(error as Any)\n } else {\n let httpResponse = response as? HTTPURLResponse\n print(httpResponse)\n }\n})\n\ndataTask.resume()","generated":true,"description":"$undefined"}]},"codeSamples":"$undefined"}],"protocol":{"type":"rest"},"includeInApiExplorer":true,"description":"$undefined","queryParameters":"$undefined","requestHeaders":"$undefined","responseHeaders":"$undefined"},"auths":[],"authsWithKeys":[],"authOptions":[],"authOptionEntries":[],"globalHeaders":[],"types":{"MessagesAgentsRequestForbiddenError":{"name":"MessagesAgentsRequestForbiddenError","shape":{"type":"object","extends":[],"properties":[{"key":"error","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"id","id":"AgentsIdMessagesPostResponsesContentApplicationJsonSchemaError"}}}},"description":"$undefined","arguments":"$undefined"}],"extraProperties":"$undefined"},"description":"$undefined"},"AgentsIdMessagesPostResponsesContentApplicationJsonSchemaError":{"name":"AgentsIdMessagesPostResponsesContentApplicationJsonSchemaError","shape":{"type":"object","extends":[],"properties":[{"key":"type","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}}}},"description":"$undefined","arguments":"$undefined"},{"key":"message","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}}}},"description":"$undefined","arguments":"$undefined"},{"key":"code","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}}}},"description":"$undefined","arguments":"$undefined"},{"key":"required_scopes","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"list","itemShape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}}}}}},"description":"$undefined","arguments":"$undefined"},{"key":"available_scopes","valueShape":{"type":"alias","value":{"type":"optional","shape":{"type":"alias","value":{"type":"list","itemShape":{"type":"alias","value":{"type":"primitive","value":{"type":"string"}}}}}}},"description":"$undefined","arguments":"$undefined"}],"extraProperties":"$undefined"},"description":"$undefined"},"Agent Messages_messagesAgents_Response_200":{"name":"Agent Messages_messagesAgents_Response_200","shape":{"type":"object","extends":[],"properties":[],"extraProperties":"$undefined"},"description":"$undefined"}}},"oauthReferencedContext":"$undefined","apiDefinitionId":"8032d34b-0da4-5b39-9317-556392035285","disableProxy":false,"disableEnvironmentEditing":false,"lang":"en"}]]}] 1f7:[["$","$L208",null,{"apiDefinitionId":"8032d34b-0da4-5b39-9317-556392035285"}],"$L20a"] 1f6:["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"[{\"@context\":\"https://schema.org\",\"@type\":\"BreadcrumbList\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recursiv Docs\",\"item\":\"https://docs.recursiv.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.recursiv.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API Reference\",\"item\":\"https://docs.recursiv.io/api-reference/api-reference/accounts/list-accounts\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Agent Messages\",\"item\":\"https://docs.recursiv.io/api-reference/agent-messages\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Messages agents\",\"item\":\"https://docs.recursiv.io/api-reference/api-reference/agent-messages/messages-agents\"}]},{\"@context\":\"https://schema.org\",\"@type\":\"TechArticle\",\"headline\":\"Messages agents\",\"url\":\"https://docs.recursiv.io/api-reference/api-reference/agent-messages/messages-agents\",\"inLanguage\":\"en\",\"isPartOf\":{\"@type\":\"WebSite\",\"name\":\"Recursiv Docs\",\"url\":\"https://docs.recursiv.io\"}}]"}}] 32:null 3e:[["$","title","0",{"children":"Messages agents | Recursiv Docs"}],["$","meta","1",{"name":"application-name","content":"Recursiv Docs"}],["$","meta","2",{"name":"generator","content":"https://buildwithfern.com"}],["$","meta","3",{"name":"fern-page-roles","content":"{\"authed\":false,\"viewers\":[\"everyone\"]}"}],["$","link","4",{"rel":"canonical","href":"https://docs.recursiv.io/api-reference/api-reference/agent-messages/messages-agents"}],["$","meta","5",{"property":"og:title","content":"Recursiv Docs"}],["$","meta","6",{"property":"og:description","content":"Quickstart, SDK, MCP and REST API reference. Build, run and govern autonomous agents on Recursiv."}],["$","meta","7",{"property":"og:url","content":"https://docs.recursiv.io/api-reference/api-reference/agent-messages/messages-agents"}],["$","meta","8",{"property":"og:site_name","content":"Recursiv Docs"}],["$","meta","9",{"property":"og:locale","content":"en_US"}],["$","meta","10",{"property":"og:image","content":"https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/recursiv.docs.buildwithfern.com/09b7f322a40d0eb3a11ccdaa8eb6ab06a0db57ed443f850126ff98e6e6f10103/assets/og/og-default.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T230959Z&X-Amz-Expires=604800&X-Amz-Signature=4a3e4c914dfeec17a24d51b178648d72f2650a0838763b6de530f08342eff88f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"}],["$","meta","11",{"property":"og:image:width","content":"1200"}],["$","meta","12",{"property":"og:image:height","content":"630"}],["$","meta","13",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","14",{"name":"twitter:site","content":"@recursivlabs"}],["$","meta","15",{"name":"twitter:creator","content":"@recursivlabs"}],["$","meta","16",{"name":"twitter:title","content":"Recursiv Docs"}],["$","meta","17",{"name":"twitter:description","content":"Quickstart, SDK, MCP and REST API reference. Build, run and govern autonomous agents on Recursiv."}],["$","meta","18",{"name":"twitter:image","content":"https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/recursiv.docs.buildwithfern.com/09b7f322a40d0eb3a11ccdaa8eb6ab06a0db57ed443f850126ff98e6e6f10103/assets/og/og-default.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T230959Z&X-Amz-Expires=604800&X-Amz-Signature=4a3e4c914dfeec17a24d51b178648d72f2650a0838763b6de530f08342eff88f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"}],["$","meta","19",{"name":"twitter:image:width","content":"1200"}],["$","meta","20",{"name":"twitter:image:height","content":"630"}],["$","link","21",{"rel":"icon","href":"/api/fern-docs/favicon.ico"}],["$","$L20b","22",{}]] 20c:T428,1fe:["$","svg",null,{"xmlns":"http://www.w3.org/2000/svg","prefix":"fas","icon":"puzzle","role":"img","viewBox":"0 0 512 512","aria-hidden":"true","focusable":"false","style":{"overflow":"visible"},"dangerouslySetInnerHTML":{"__html":"$20c"}}] 200:["$","svg",null,{"xmlns":"http://www.w3.org/2000/svg","prefix":"fas","icon":"rss","role":"img","viewBox":"0 0 448 512","aria-hidden":"true","focusable":"false","style":{"overflow":"visible"},"dangerouslySetInnerHTML":{"__html":""}}] 1fc:["$","svg",null,{"xmlns":"http://www.w3.org/2000/svg","prefix":"fas","icon":"terminal","role":"img","viewBox":"0 0 512 512","aria-hidden":"true","focusable":"false","style":{"overflow":"visible"},"dangerouslySetInnerHTML":{"__html":""}}] 1ff:["$","svg",null,{"xmlns":"http://www.w3.org/2000/svg","prefix":"fas","icon":"chart-bar","role":"img","viewBox":"0 0 512 512","aria-hidden":"true","focusable":"false","style":{"overflow":"visible"},"dangerouslySetInnerHTML":{"__html":""}}]

Path parameters

Response

Errors