Optional timestamp for the message. Workflow callers should pass workflow.now() (Temporal's deterministic monotonic clock) so that two awaited messages.create calls from the same workflow are guaranteed to have monotonic timestamps regardless of HTTP scheduling at the server. If omitted, the server's wall clock at insert time is used.
Response
Successful Response
Represents a message in the agent system.
This entity is used to store messages in MongoDB, with each message
associated with a specific task.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scale AI","colors":{"primary":"#3f2e7b","light":"#ca62ff","dark":"#3f2e7b"},"logo":{"light":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b","dark":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/dark.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=02733f39d684d796ec742853eabf0de5"},"favicon":"https://mintcdn.com/scalegp/1vQnbXFkjbQbcgd1/favicon.png?fit=max\u0026auto=format\u0026n=1vQnbXFkjbQbcgd1\u0026q=85\u0026s=f52c84ba46a7cca58551673616dabe9c","background":{"decoration":"windows"},"navbar":{"links":[],"primary":{"type":"button","label":"Platform","href":"https://app.sgp.scale.com/"}},"footer":{"socials":{"x":"https://x.com/scale_ai","facebook":"https://www.facebook.com/scaleapi","linkedin":"https://www.linkedin.com/company/scaleai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scalegp","hasAudioNarration":false,"actualSubdomain":"scalegp","customDomains":["docs.gp.scale.com"],"gitSource":{"type":"github","owner":"scaleapi","repo":"sgp-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6abeb90f3a8b8379c1eaf648","collectionId":"437f531c-55bf-41b5-8f5d-4e63781df61e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abeb90f3a8b8379c1eaf648"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6abeb90f3a8b8379c1eaf648","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":235},{"language":"default","tag":"AgentOps API","count":141},{"language":"default","tag":"Guides","count":131},{"language":"default","tag":"Agentex API","count":94},{"language":"default","tag":"Evaluations","count":72},{"language":"default","tag":"Dex API","count":48},{"language":"default","tag":"Agents","count":41},{"language":"default","tag":"Evaluation Datasets","count":34},{"language":"default","tag":"Models","count":32},{"language":"default","tag":"Knowledge Bases","count":31}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:'Aeonik';src:url(https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2);font-weight:400;font-style:normal;font-display:swap}h1,h2,h3{font-family:'aeonik';letter-spacing:normal!important}"}],"page":{"pagePath":"reference/agentex/messages/create-message","slug":"/reference/agentex/messages/create-message","pageMetadata":{"title":"Create Message","description":null,"deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /messages","href":"/reference/agentex/messages/create-message","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Message","description":null,"deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /messages","href":"/reference/agentex/messages/create-message","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Messages"],"summary":"Create Message","operationId":"create_message_messages_post","requestBody":"12d3d008-ae9e-4865-9cd6-0a007be68e5a","responses":{"200":"c95514d7-2e77-415d-be8b-b0fcb9cfddd5","422":"df60de61-ac09-4076-a661-491b068cfa58"},"method":"post","type":"path","servers":[],"security":[],"path":"/messages","baseUrlOptions":[],"title":"Create Message","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"task_id":{"type":"string","title":"The unique id of the task to send the message to","isRequired":true,"uniqueKey":"task_id","typeLabel":"string"},"content":{"oneOf":[{"type":"object","title":"TextContent","required":["author","content"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.0.author","typeLabel":"enum\u003cstring>"},"content":{"type":"string","title":"Content","description":"The contents of the text message.","isRequired":true,"uniqueKey":"content.oneOf.0.content","typeLabel":"string"},"type":{"type":"string","const":"text","title":"Type","description":"The type of the message, in this case `text`.","default":"text","uniqueKey":"content.oneOf.0.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.0.style","typeLabel":"enum\u003cstring>"},"format":{"type":"string","enum":["markdown","plain","code"],"title":"TextFormat","description":"The format of the message. This is used by the client to determine how to display the message.","default":"plain","uniqueKey":"content.oneOf.0.format","typeLabel":"enum\u003cstring>"},"attachments":{"oneOf":[{"type":"array","items":{"properties":{"file_id":{"type":"string","title":"File Id","description":"The unique ID of the attached file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].file_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].name","typeLabel":"string"},"size":{"type":"integer","title":"Size","description":"The size of the file in bytes","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].size","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"The MIME type or content type of the file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["file_id","name","size","type"],"title":"FileAttachment","description":"Represents a file attachment in messages.","uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX]","typeLabel":"FileAttachment · object"},"title":"Attachments","description":"Optional list of file attachments with structured metadata.","uniqueKey":"content.oneOf.0.attachments.oneOf.0","typeLabel":"FileAttachment · object[]"},{"type":"null","title":"Attachments","description":"Optional list of file attachments with structured metadata.","uniqueKey":"content.oneOf.0.attachments.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.0.attachments","typeLabel":"FileAttachment · object[] | null"}},"isRequired":true,"uniqueKey":"content.oneOf.0","typeLabel":"TextContent · object"},{"type":"object","title":"ReasoningContent","required":["author","summary"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.1.author","typeLabel":"enum\u003cstring>"},"summary":{"items":{"type":"string","uniqueKey":"content.oneOf.1.summary.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Summary","description":"A list of short reasoning summaries","isRequired":true,"uniqueKey":"content.oneOf.1.summary","typeLabel":"string[]"},"type":{"type":"string","const":"reasoning","title":"Type","description":"The type of the message, in this case `reasoning`.","default":"reasoning","uniqueKey":"content.oneOf.1.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.1.style","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"content.oneOf.1.content.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Content","description":"The reasoning content or chain-of-thought text","uniqueKey":"content.oneOf.1.content.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Content","description":"The reasoning content or chain-of-thought text","uniqueKey":"content.oneOf.1.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.1.content","typeLabel":"string[] | null"}},"isRequired":true,"uniqueKey":"content.oneOf.1","typeLabel":"ReasoningContent · object"},{"type":"object","title":"DataContent","required":["author","data"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.2.author","typeLabel":"enum\u003cstring>"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"The contents of the data message.","isRequired":true,"uniqueKey":"content.oneOf.2.data","typeLabel":"Data · object"},"type":{"type":"string","const":"data","title":"Type","description":"The type of the message, in this case `data`.","default":"data","uniqueKey":"content.oneOf.2.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.2.style","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"content.oneOf.2","typeLabel":"DataContent · object"},{"type":"object","title":"ToolRequestContent","required":["author","tool_call_id","name","arguments"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.3.author","typeLabel":"enum\u003cstring>"},"tool_call_id":{"type":"string","title":"Tool Call Id","description":"The ID of the tool call that is being requested.","isRequired":true,"uniqueKey":"content.oneOf.3.tool_call_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the tool that is being requested.","isRequired":true,"uniqueKey":"content.oneOf.3.name","typeLabel":"string"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"The arguments to the tool.","isRequired":true,"uniqueKey":"content.oneOf.3.arguments","typeLabel":"Arguments · object"},"type":{"type":"string","const":"tool_request","title":"Type","description":"The type of the message, in this case `tool_request`.","default":"tool_request","uniqueKey":"content.oneOf.3.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"content.oneOf.3","typeLabel":"ToolRequestContent · object"},{"type":"object","title":"ToolResponseContent","required":["author","tool_call_id","name","content"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.4.author","typeLabel":"enum\u003cstring>"},"tool_call_id":{"type":"string","title":"Tool Call Id","description":"The ID of the tool call that is being responded to.","isRequired":true,"uniqueKey":"content.oneOf.4.tool_call_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the tool that is being responded to.","isRequired":true,"uniqueKey":"content.oneOf.4.name","typeLabel":"string"},"content":{"title":"Content","description":"The result of the tool.","isRequired":true,"uniqueKey":"content.oneOf.4.content","typeLabel":"any"},"type":{"type":"string","const":"tool_response","title":"Type","description":"The type of the message, in this case `tool_response`.","default":"tool_response","uniqueKey":"content.oneOf.4.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.4.style","typeLabel":"enum\u003cstring>"},"is_error":{"oneOf":[{"type":"boolean","title":"Is Error","description":"Whether the tool call resulted in an error. `None` when the harness does not report a status.","uniqueKey":"content.oneOf.4.is_error.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Error","description":"Whether the tool call resulted in an error. `None` when the harness does not report a status.","uniqueKey":"content.oneOf.4.is_error.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.4.is_error","typeLabel":"boolean | null"}},"isRequired":true,"uniqueKey":"content.oneOf.4","typeLabel":"ToolResponseContent · object"}],"isRequired":true,"uniqueKey":"content","typeLabel":"TextContent · object | ReasoningContent · object | DataContent · object | ToolRequestContent · object | ToolResponseContent · object"},"streaming_status":{"oneOf":[{"type":"string","title":"The streaming status of the message","enum":["IN_PROGRESS","DONE"],"uniqueKey":"streaming_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"The streaming status of the message","uniqueKey":"streaming_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"streaming_status","typeLabel":"enum\u003cstring> | null"},"created_at":{"oneOf":[{"type":"string","title":"Optional caller-supplied creation timestamp","description":"Optional timestamp for the message. Workflow callers should pass workflow.now() (Temporal's deterministic monotonic clock) so that two awaited messages.create calls from the same workflow are guaranteed to have monotonic timestamps regardless of HTTP scheduling at the server. If omitted, the server's wall clock at insert time is used.","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Optional caller-supplied creation timestamp","description":"Optional timestamp for the message. Workflow callers should pass workflow.now() (Temporal's deterministic monotonic clock) so that two awaited messages.create calls from the same workflow are guaranteed to have monotonic timestamps regardless of HTTP scheduling at the server. If omitted, the server's wall clock at insert time is used.","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["task_id","content"],"title":"CreateTaskMessageRequest","uniqueKey":"","typeLabel":"CreateTaskMessageRequest · object"},"examples":{"Example":{"title":"Example","value":{"task_id":"\u003cstring>","content":{"content":"\u003cstring>","type":"text","style":"static","format":"plain","attachments":[{"file_id":"\u003cstring>","name":"\u003cstring>","size":123,"type":"\u003cstring>"}]},"created_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c95514d7-2e77-415d-be8b-b0fcb9cfddd5":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"ID of the task this message belongs to","isRequired":true,"uniqueKey":"task_id","typeLabel":"string"},"content":{"oneOf":[{"type":"object","title":"TextContent","description":"The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user.","required":["author","content"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.0.author","typeLabel":"enum\u003cstring>"},"content":{"type":"string","title":"Content","description":"The contents of the text message.","isRequired":true,"uniqueKey":"content.oneOf.0.content","typeLabel":"string"},"type":{"type":"string","const":"text","title":"Type","description":"The type of the message, in this case `text`.","default":"text","uniqueKey":"content.oneOf.0.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.0.style","typeLabel":"enum\u003cstring>"},"format":{"type":"string","enum":["markdown","plain","code"],"title":"TextFormat","description":"The format of the message. This is used by the client to determine how to display the message.","default":"plain","uniqueKey":"content.oneOf.0.format","typeLabel":"enum\u003cstring>"},"attachments":{"oneOf":[{"type":"array","items":{"properties":{"file_id":{"type":"string","title":"File Id","description":"The unique ID of the attached file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].file_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].name","typeLabel":"string"},"size":{"type":"integer","title":"Size","description":"The size of the file in bytes","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].size","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"The MIME type or content type of the file","isRequired":true,"uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["file_id","name","size","type"],"title":"FileAttachment","description":"Represents a file attachment in messages.","uniqueKey":"content.oneOf.0.attachments.oneOf.0.items.[INDEX]","typeLabel":"FileAttachment · object"},"title":"Attachments","description":"Optional list of file attachments with structured metadata.","uniqueKey":"content.oneOf.0.attachments.oneOf.0","typeLabel":"FileAttachment · object[]"},{"type":"null","title":"Attachments","description":"Optional list of file attachments with structured metadata.","uniqueKey":"content.oneOf.0.attachments.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.0.attachments","typeLabel":"FileAttachment · object[] | null"}},"isRequired":true,"uniqueKey":"content.oneOf.0","typeLabel":"TextContent · object"},{"type":"object","title":"ReasoningContent","description":"The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user.","required":["author","summary"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.1.author","typeLabel":"enum\u003cstring>"},"summary":{"items":{"type":"string","uniqueKey":"content.oneOf.1.summary.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Summary","description":"A list of short reasoning summaries","isRequired":true,"uniqueKey":"content.oneOf.1.summary","typeLabel":"string[]"},"type":{"type":"string","const":"reasoning","title":"Type","description":"The type of the message, in this case `reasoning`.","default":"reasoning","uniqueKey":"content.oneOf.1.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.1.style","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"content.oneOf.1.content.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Content","description":"The reasoning content or chain-of-thought text","uniqueKey":"content.oneOf.1.content.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Content","description":"The reasoning content or chain-of-thought text","uniqueKey":"content.oneOf.1.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.1.content","typeLabel":"string[] | null"}},"isRequired":true,"uniqueKey":"content.oneOf.1","typeLabel":"ReasoningContent · object"},{"type":"object","title":"DataContent","description":"The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user.","required":["author","data"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.2.author","typeLabel":"enum\u003cstring>"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"The contents of the data message.","isRequired":true,"uniqueKey":"content.oneOf.2.data","typeLabel":"Data · object"},"type":{"type":"string","const":"data","title":"Type","description":"The type of the message, in this case `data`.","default":"data","uniqueKey":"content.oneOf.2.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.2.style","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"content.oneOf.2","typeLabel":"DataContent · object"},{"type":"object","title":"ToolRequestContent","description":"The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user.","required":["author","tool_call_id","name","arguments"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.3.author","typeLabel":"enum\u003cstring>"},"tool_call_id":{"type":"string","title":"Tool Call Id","description":"The ID of the tool call that is being requested.","isRequired":true,"uniqueKey":"content.oneOf.3.tool_call_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the tool that is being requested.","isRequired":true,"uniqueKey":"content.oneOf.3.name","typeLabel":"string"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"The arguments to the tool.","isRequired":true,"uniqueKey":"content.oneOf.3.arguments","typeLabel":"Arguments · object"},"type":{"type":"string","const":"tool_request","title":"Type","description":"The type of the message, in this case `tool_request`.","default":"tool_request","uniqueKey":"content.oneOf.3.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"content.oneOf.3","typeLabel":"ToolRequestContent · object"},{"type":"object","title":"ToolResponseContent","description":"The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user.","required":["author","tool_call_id","name","content"],"properties":{"author":{"type":"string","enum":["user","agent"],"title":"MessageAuthor","description":"The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`.","isRequired":true,"uniqueKey":"content.oneOf.4.author","typeLabel":"enum\u003cstring>"},"tool_call_id":{"type":"string","title":"Tool Call Id","description":"The ID of the tool call that is being responded to.","isRequired":true,"uniqueKey":"content.oneOf.4.tool_call_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"The name of the tool that is being responded to.","isRequired":true,"uniqueKey":"content.oneOf.4.name","typeLabel":"string"},"content":{"title":"Content","description":"The result of the tool.","isRequired":true,"uniqueKey":"content.oneOf.4.content","typeLabel":"any"},"type":{"type":"string","const":"tool_response","title":"Type","description":"The type of the message, in this case `tool_response`.","default":"tool_response","uniqueKey":"content.oneOf.4.type","typeLabel":"string"},"style":{"type":"string","enum":["static","active"],"title":"MessageStyle","description":"The style of the message. This is used by the client to determine how to display the message.","default":"static","uniqueKey":"content.oneOf.4.style","typeLabel":"enum\u003cstring>"},"is_error":{"oneOf":[{"type":"boolean","title":"Is Error","description":"Whether the tool call resulted in an error. `None` when the harness does not report a status.","uniqueKey":"content.oneOf.4.is_error.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Error","description":"Whether the tool call resulted in an error. `None` when the harness does not report a status.","uniqueKey":"content.oneOf.4.is_error.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.oneOf.4.is_error","typeLabel":"boolean | null"}},"isRequired":true,"uniqueKey":"content.oneOf.4","typeLabel":"ToolResponseContent · object"}],"isRequired":true,"uniqueKey":"content","typeLabel":"TextContent · object | ReasoningContent · object | DataContent · object | ToolRequestContent · object | ToolResponseContent · object"},"id":{"oneOf":[{"type":"string","title":"Id","description":"The task message's unique id","uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Id","description":"The task message's unique id","uniqueKey":"id.oneOf.1","typeLabel":"null"}],"uniqueKey":"id","typeLabel":"string | null"},"streaming_status":{"oneOf":[{"type":"string","title":"In case of streaming, this indicates whether the message is still being streamed or has been completed","enum":["IN_PROGRESS","DONE"],"uniqueKey":"streaming_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"In case of streaming, this indicates whether the message is still being streamed or has been completed","uniqueKey":"streaming_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"streaming_status","typeLabel":"enum\u003cstring> | null"},"created_at":{"oneOf":[{"type":"string","title":"Created At","description":"The timestamp when the message was created","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created At","description":"The timestamp when the message was created","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","description":"The timestamp when the message was last updated","format":"date-time","uniqueKey":"updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated At","description":"The timestamp when the message was last updated","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["task_id","content"],"title":"TaskMessage","description":"Represents a message in the agent system.\n\nThis entity is used to store messages in MongoDB, with each message\nassociated with a specific task.","uniqueKey":"","typeLabel":"TaskMessage · object"},"examples":{"Example":{"title":"Example","value":{"task_id":"\u003cstring>","content":{"author":"user","content":"\u003cstring>","type":"text","style":"static","format":"plain","attachments":[{"file_id":"\u003cstring>","name":"\u003cstring>","size":123,"type":"\u003cstring>"}]},"id":"\u003cstring>","streaming_status":"IN_PROGRESS","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"df60de61-ac09-4076-a661-491b068cfa58":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{}},"originalFileLocation":"https://agentex.dev-sgp.scale.com/openapi.json"},"subdomain":"scalegp","siteName":"Scale AI","title":"Create Message - Scale AI","navMaps":{"firstHrefInVersion":{"V5":{"href":"/reference/agentex/messages/create-message","matchLevel":0},"V4 (legacy)":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T19:48:42.654Z","originalFileLocation":"reference/agentex/messages/create-message.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Message - Scale AI\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scale AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gp.scale.com/reference/agentex/messages/create-message\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scalegp.mintlify.app/_mintlify/api/og/v2?division=Messages\u0026amp;title=Create+Message\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=096e87164054441140947af6e0ce0ea79db82f2de815696a113b1b3995b540d7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Message - Scale AI\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scalegp.mintlify.app/_mintlify/api/og/v2?division=Messages\u0026amp;title=Create+Message\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=096e87164054441140947af6e0ce0ea79db82f2de815696a113b1b3995b540d7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3f2e7b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gp.scale.com/reference/agentex/messages/create-message\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/agentex/messages/create-message.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gp.scale.com/#organization\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gp.scale.com#website\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message#webpage\",\"url\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message\",\"name\":\"Create Message\",\"dateModified\":\"2026-10-01T19:48:42.654Z\",\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messages\",\"item\":\"https://docs.gp.scale.com/reference/agentex/messages/batch-update-messages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Message\",\"item\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message#apireference\",\"headline\":\"Create Message\",\"name\":\"Create Message\",\"url\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gp.scale.com/reference/agentex/messages/create-message#webpage\"},\"dateModified\":\"2026-10-01T19:48:42.654Z\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"}}]}\u003c/script>","siteName":"Scale AI","nav":{"global":null,"versions":[{"version":"V5","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/v5/overview"}]},{"tab":"AgentOps API","pages":[{"title":"AgentOps API","href":"/reference/v5/inference/run-inference-with-free-form-payload"}]},{"tab":"AgentOps SDK","href":"https://scaleapi.github.io/sgp-sdk-docs/api/python/"},{"tab":"Agentex API","groups":[{"group":"Agents","pages":[{"title":"Get Agent by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}","href":"/reference/agentex/agents/get-agent-by-id"},{"title":"Delete Agent by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agents/{agent_id}","href":"/reference/agentex/agents/delete-agent-by-id"},{"title":"Get Agent by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/name/{agent_name}","href":"/reference/agentex/agents/get-agent-by-name"},{"title":"Delete Agent by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agents/name/{agent_name}","href":"/reference/agentex/agents/delete-agent-by-name"},{"title":"List Agents","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents","href":"/reference/agentex/agents/list-agents"},{"title":"Register Agent","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/register","href":"/reference/agentex/agents/register-agent"},{"title":"Register Build","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/register-build","href":"/reference/agentex/agents/register-build"},{"title":"Forward GET request to agent by name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/forward/name/{agent_name}/{path}","href":"/reference/agentex/agents/forward-get-request-to-agent-by-name"},{"title":"Forward POST request to agent by name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/forward/name/{agent_name}/{path}","href":"/reference/agentex/agents/forward-post-request-to-agent-by-name"},{"title":"Handle Agent RPC by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/rpc","href":"/reference/agentex/agents/handle-agent-rpc-by-id"},{"title":"Handle Agent RPC by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/name/{agent_name}/rpc","href":"/reference/agentex/agents/handle-agent-rpc-by-name"}]},{"group":"Tasks","pages":[{"title":"Get Task by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/{task_id}","href":"/reference/agentex/tasks/get-task-by-id"},{"title":"Update Task by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /tasks/{task_id}","href":"/reference/agentex/tasks/update-task-by-id"},{"title":"Delete Task by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /tasks/{task_id}","href":"/reference/agentex/tasks/delete-task-by-id"},{"title":"Get Task by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/name/{task_name}","href":"/reference/agentex/tasks/get-task-by-name"},{"title":"Update Task by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /tasks/name/{task_name}","href":"/reference/agentex/tasks/update-task-by-name"},{"title":"Delete Task by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /tasks/name/{task_name}","href":"/reference/agentex/tasks/delete-task-by-name"},{"title":"List Tasks","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks","href":"/reference/agentex/tasks/list-tasks"},{"title":"Complete Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/complete","href":"/reference/agentex/tasks/complete-task"},{"title":"Fail Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/fail","href":"/reference/agentex/tasks/fail-task"},{"title":"Cancel Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/cancel","href":"/reference/agentex/tasks/cancel-task"},{"title":"Interrupt Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/interrupt","href":"/reference/agentex/tasks/interrupt-task"},{"title":"Terminate Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/terminate","href":"/reference/agentex/tasks/terminate-task"},{"title":"Timeout Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/timeout","href":"/reference/agentex/tasks/timeout-task"},{"title":"Stream Task Events by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/{task_id}/stream","href":"/reference/agentex/tasks/stream-task-events-by-id"},{"title":"Stream Task Events by Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/name/{task_name}/stream","href":"/reference/agentex/tasks/stream-task-events-by-name"},{"title":"Query Task Workflow","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/{task_id}/query/{query_name}","href":"/reference/agentex/tasks/query-task-workflow"}]},{"group":"Messages","pages":[{"title":"Batch Update Messages","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /messages/batch","href":"/reference/agentex/messages/batch-update-messages"},{"title":"Batch Create Messages","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /messages/batch","href":"/reference/agentex/messages/batch-create-messages"},{"title":"List Messages","description":"List messages for a task with offset-based pagination.\n\nFor cursor-based pagination with infinite scroll support, use /messages/paginated.","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /messages","href":"/reference/agentex/messages/list-messages"},{"title":"Create Message","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /messages","href":"/reference/agentex/messages/create-message"},{"title":"Get Message","description":null,"deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /messages/{message_id}","href":"/reference/agentex/messages/get-message"},{"title":"Update Message","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /messages/{message_id}","href":"/reference/agentex/messages/update-message"},{"title":"List Messages Paginated","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /messages/paginated","href":"/reference/agentex/messages/list-messages-paginated"}]},{"group":"Spans","pages":[{"title":"List Spans","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /spans","href":"/reference/agentex/spans/list-spans"},{"title":"Create Span","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /spans","href":"/reference/agentex/spans/create-span"},{"title":"Get Span","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /spans/{span_id}","href":"/reference/agentex/spans/get-span"},{"title":"Partial Update Span","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json patch /spans/{span_id}","href":"/reference/agentex/spans/partial-update-span"}]},{"group":"States","pages":[{"title":"List States","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /states","href":"/reference/agentex/states/list-states"},{"title":"Create Task State","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /states","href":"/reference/agentex/states/create-task-state"},{"title":"Get State by State ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /states/{state_id}","href":"/reference/agentex/states/get-state-by-state-id"},{"title":"Update Task State","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /states/{state_id}","href":"/reference/agentex/states/update-task-state"},{"title":"Delete Task State","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /states/{state_id}","href":"/reference/agentex/states/delete-task-state"}]},{"group":"Events","pages":[{"title":"Get Event","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /events/{event_id}","href":"/reference/agentex/events/get-event"},{"title":"List Events","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /events","href":"/reference/agentex/events/list-events"}]},{"group":"Slack","pages":[{"title":"Slack Events API ingress for the @agent app","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /slack/events","href":"/reference/agentex/slack/slack-events-api-ingress-for-the-@agent-app"},{"title":"Slack slash-command ingress (e.g. /agents)","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /slack/commands","href":"/reference/agentex/slack/slack-slash-command-ingress-eg-agents"},{"title":"Slack interactivity ingress (modals, shortcuts)","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /slack/interactions","href":"/reference/agentex/slack/slack-interactivity-ingress-modals-shortcuts"}]},{"group":"Agent Task Tracker","pages":[{"title":"Get Agent Task Tracker","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tracker/{tracker_id}","href":"/reference/agentex/agent-task-tracker/get-agent-task-tracker"},{"title":"Update Agent Task Tracker","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json put /tracker/{tracker_id}","href":"/reference/agentex/agent-task-tracker/update-agent-task-tracker"},{"title":"List Agent Task Trackers","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tracker","href":"/reference/agentex/agent-task-tracker/list-agent-task-trackers"}]},{"group":"Agent APIKeys","pages":[{"title":"List API keys for an agent ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agent_api_keys","href":"/reference/agentex/agent-apikeys/list-api-keys-for-an-agent-id"},{"title":"Create Api Key","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agent_api_keys","href":"/reference/agentex/agent-apikeys/create-api-key"},{"title":"Create Webhook Trigger","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agent_api_keys/webhook-trigger","href":"/reference/agentex/agent-apikeys/create-webhook-trigger"},{"title":"Return named API key for the agent ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agent_api_keys/name/{name}","href":"/reference/agentex/agent-apikeys/return-named-api-key-for-the-agent-id"},{"title":"Return the API key by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agent_api_keys/{id}","href":"/reference/agentex/agent-apikeys/return-the-api-key-by-id"},{"title":"Delete API key by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agent_api_keys/{id}","href":"/reference/agentex/agent-apikeys/delete-api-key-by-id"},{"title":"Delete API key by name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agent_api_keys/name/{api_key_name}","href":"/reference/agentex/agent-apikeys/delete-api-key-by-name"}]},{"group":"Linear","pages":[{"title":"Linear agent webhook ingress for the @agentex app","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /linear/events","href":"/reference/agentex/linear/linear-agent-webhook-ingress-for-the-@agentex-app"}]},{"group":"Integrations","pages":[{"title":"Confirm linking a Slack identity to SGP","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /integrations/slack/link","href":"/reference/agentex/integrations/confirm-linking-a-slack-identity-to-sgp"},{"title":"Complete a Slack identity link","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /integrations/slack/link","href":"/reference/agentex/integrations/complete-a-slack-identity-link"}]},{"group":"Deployment History","pages":[{"title":"Get Deployment by ID","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /deployment-history/{deployment_id}","href":"/reference/agentex/deployment-history/get-deployment-by-id"},{"title":"List Deployments for an agent","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /deployment-history","href":"/reference/agentex/deployment-history/list-deployments-for-an-agent"}]},{"group":"Deployments","pages":[{"title":"List Deployments","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}/deployments","href":"/reference/agentex/deployments/list-deployments"},{"title":"Create Deployment","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/deployments","href":"/reference/agentex/deployments/create-deployment"},{"title":"Get Deployment","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}/deployments/{deployment_id}","href":"/reference/agentex/deployments/get-deployment"},{"title":"Delete Deployment","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agents/{agent_id}/deployments/{deployment_id}","href":"/reference/agentex/deployments/delete-deployment"},{"title":"Promote Deployment","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/deployments/{deployment_id}/promote","href":"/reference/agentex/deployments/promote-deployment"},{"title":"Preview RPC","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/deployments/{deployment_id}/rpc","href":"/reference/agentex/deployments/preview-rpc"}]},{"group":"Schedules","pages":[{"title":"List Run Schedules","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}/schedules","href":"/reference/agentex/schedules/list-run-schedules"},{"title":"Create Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules","href":"/reference/agentex/schedules/create-run-schedule"},{"title":"Get Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}/schedules/name/{name}","href":"/reference/agentex/schedules/get-run-schedule-by-name"},{"title":"Delete Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agents/{agent_id}/schedules/name/{name}","href":"/reference/agentex/schedules/delete-run-schedule-by-name"},{"title":"Update Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json patch /agents/{agent_id}/schedules/name/{name}","href":"/reference/agentex/schedules/update-run-schedule-by-name"},{"title":"Get Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /agents/{agent_id}/schedules/{schedule_id}","href":"/reference/agentex/schedules/get-run-schedule"},{"title":"Delete Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json delete /agents/{agent_id}/schedules/{schedule_id}","href":"/reference/agentex/schedules/delete-run-schedule"},{"title":"Update Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json patch /agents/{agent_id}/schedules/{schedule_id}","href":"/reference/agentex/schedules/update-run-schedule"},{"title":"Trigger Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/name/{name}/trigger","href":"/reference/agentex/schedules/trigger-run-schedule-by-name"},{"title":"Trigger Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/{schedule_id}/trigger","href":"/reference/agentex/schedules/trigger-run-schedule"},{"title":"Skip Run Schedule Action","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/{schedule_id}/skip","href":"/reference/agentex/schedules/skip-run-schedule-action"},{"title":"Unskip Run Schedule Action","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/{schedule_id}/unskip","href":"/reference/agentex/schedules/unskip-run-schedule-action"},{"title":"Pause Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/name/{name}/pause","href":"/reference/agentex/schedules/pause-run-schedule-by-name"},{"title":"Pause Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/{schedule_id}/pause","href":"/reference/agentex/schedules/pause-run-schedule"},{"title":"Resume Run Schedule By Name","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/name/{name}/resume","href":"/reference/agentex/schedules/resume-run-schedule-by-name"},{"title":"Resume Run Schedule","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /agents/{agent_id}/schedules/{schedule_id}/resume","href":"/reference/agentex/schedules/resume-run-schedule"}]},{"group":"Checkpoints","pages":[{"title":"Get Checkpoint Tuple","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /checkpoints/get-tuple","href":"/reference/agentex/checkpoints/get-checkpoint-tuple"},{"title":"Put Checkpoint","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /checkpoints/put","href":"/reference/agentex/checkpoints/put-checkpoint"},{"title":"Put Writes","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /checkpoints/put-writes","href":"/reference/agentex/checkpoints/put-writes"},{"title":"List Checkpoints","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /checkpoints/list","href":"/reference/agentex/checkpoints/list-checkpoints"},{"title":"Delete Thread","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /checkpoints/delete-thread","href":"/reference/agentex/checkpoints/delete-thread"}]},{"group":"task-retention","pages":[{"title":"Export Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json get /tasks/{task_id}/export","href":"/reference/agentex/task-retention/export-task"},{"title":"Export Task To Url","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/export","href":"/reference/agentex/task-retention/export-task-to-url"},{"title":"Clean Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/clean","href":"/reference/agentex/task-retention/clean-task"},{"title":"Rehydrate Task","deprecated":null,"version":null,"openapi":"https://agentex.dev-sgp.scale.com/openapi.json post /tasks/{task_id}/rehydrate","href":"/reference/agentex/task-retention/rehydrate-task"}]}]},{"tab":"Agentex SDK","href":"https://scaleapi.github.io/agentex-sdk-docs/api/python/"},{"tab":"Capabilities","pages":[{"title":"Capabilities","href":"/docs/capabilities/overview"}]},{"tab":"Dex API","pages":[{"title":"Dex API","href":"/reference/dex/projects/list-projects"}]}]},{"version":"V4 (legacy)","pages":[{"title":"V4 (legacy)","href":"/home"}]}]},"title":"Create Message - Scale AI","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}