List Runs

List all runs.

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_atdatetimeOptional

The timestamp when the object was created.

updated_atdatetimeOptional

The timestamp when the object was last updated.

statusenumOptional

The status of the job.

Allowed values:

completed_atdatetimeOptional

The unix timestamp of when the job was completed.

metadatamap from strings to anyOptional

The metadata of the job.

job_typeenumOptional

Allowed values:

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

The human-friendly ID of the Run

request_configobjectOptional

The request configuration for the run.

1	[
2	{
3	"created_by_id": "created_by_id",
4	"last_updated_by_id": "last_updated_by_id",
5	"created_at": "2024-01-15T09:30:00Z",
6	"updated_at": "2024-01-15T09:30:00Z",
7	"status": "created",
8	"completed_at": "2024-01-15T09:30:00Z",
9	"metadata": {
10	"key": "value"
11	},
12	"job_type": "job",
13	"id": "run-123e4567-e89b-12d3-a456-426614174000",
14	"request_config": {
15	"use_assistant_message": true,
16	"assistant_message_tool_name": "assistant_message_tool_name",
17	"assistant_message_tool_kwarg": "assistant_message_tool_kwarg"
18	}
19	}
20	]

1	curl https://api.letta.com/v1/runs/ \
2	-H "Authorization: Bearer <token>"