Retrieve Run

Get the status of a run.

run_idstringRequired

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.

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	"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": "not_started",
7	"completed_at": "2024-01-15T09:30:00Z",
8	"metadata": {
9	"key": "value"
10	},
11	"job_type": "job",
12	"id": "run-123e4567-e89b-12d3-a456-426614174000",
13	"request_config": {
14	"use_assistant_message": true,
15	"assistant_message_tool_name": "assistant_message_tool_name",
16	"assistant_message_tool_kwarg": "assistant_message_tool_kwarg"
17	}
18	}

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