Send Message Async

Asynchronously process a user message and return a run object. The actual processing happens in the background, and the status can be checked using the run ID.

Path parameters

agent_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Request

This endpoint expects an object.

messageslist of objectsRequired

The messages to be sent to the agent.

use_assistant_messagebooleanOptionalDefaults to true

Whether the server should parse specific tool call arguments (default send_message) as AssistantMessage objects.

assistant_message_tool_namestringOptionalDefaults to send_message

The name of the designated message tool.

assistant_message_tool_kwargstringOptionalDefaults to message

The name of the message argument in the designated message tool.

Response

Successful Response

created_by_idstringOptional

The id of the user that made this object.

last_updated_by_idstringOptional

The id of the user that made this object.

created_atstringOptionalformat: "date-time"

The timestamp when the object was created.

updated_atstringOptionalformat: "date-time"

The timestamp when the object was last updated.

statusenumOptional

The status of the job.

completed_atstringOptionalformat: "date-time"

The unix timestamp of when the job was completed.

metadataobjectOptional

The metadata of the job.

job_typeenumOptional

Allowed values:

callback_urlstringOptional

If set, POST to this URL when the job completes.

callback_sent_atstringOptionalformat: "date-time"

Timestamp when the callback was last attempted.

callback_status_codeintegerOptional

HTTP status code returned by the callback endpoint.

idstringOptionalformat: "^(job|run)-[a-fA-F0-9]{8}"

The human-friendly ID of the Run

request_configobjectOptional

The request configuration for the run.

1	curl -X POST https://api.letta.com/v1/agents/ \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"messages": [
6	{
7	"role": "user",
8	"content": [
9	{}
10	]
11	}
12	]
13	}'

1	{
2	"created_by_id": "foo",
3	"last_updated_by_id": "foo",
4	"created_at": "foo",
5	"updated_at": "foo",
6	"status": "not_started",
7	"completed_at": "foo",
8	"metadata": {},
9	"job_type": "job",
10	"callback_url": "foo",
11	"callback_sent_at": "foo",
12	"callback_status_code": 42,
13	"id": "run-123e4567-e89b-12d3-a456-426614174000",
14	"request_config": {
15	"use_assistant_message": true,
16	"assistant_message_tool_name": "send_message",
17	"assistant_message_tool_kwarg": "message"
18	}
19	}