Send Message Async — Letta

agent_idstringRequired

This endpoint expects an object.

messageslist of objectsRequired

The messages to be sent to the agent.

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.

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_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The timestamp when the object was created.

updated_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The timestamp when the object was last updated.

statusenumOptional

Allowed values: createdrunningcompletedfailedpending

The status of the job.

completed_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The unix timestamp of when the job was completed.

metadata_map from strings to anyOptional

The metadata of the job.

idstringOptionalformat: "^job-[a-fA-F0-9]{8}"

The human-friendly ID of the Job

user_idstringOptional

The unique identifier of the user associated with the job.

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

1	{
2	"created_by_id": "created_by_id",
3	"last_updated_by_id": "last_updated_by_id",
4	"created_at": "2024-01-15T09:30:00Z",
5	"updated_at": "2024-01-15T09:30:00Z",
6	"status": "created",
7	"completed_at": "2024-01-15T09:30:00Z",
8	"metadata_": {
9	"key": "value"
10	},
11	"id": "job-123e4567-e89b-12d3-a456-426614174000",
12	"user_id": "user_id"
13	}