Retrieve Step

Successful Response

idstring

The id of the step. Assigned by the database.

originstringOptional

The surface that this agent step was initiated from.

provider_idstringOptional

The unique identifier of the provider that was configured for this step

job_idstringOptional

The unique identifier of the job that this step belongs to. Only included for async calls.

provider_namestringOptional

The name of the provider used for this step.

modelstringOptional

The name of the model used for this step.

context_window_limitintegerOptional

The context window limit configured for this step.

completion_tokensintegerOptional

The number of tokens generated by the agent during this step.

prompt_tokensintegerOptional

The number of tokens in the prompt during this step.

total_tokensintegerOptional

The total number of tokens processed by the agent during this step.

completion_tokens_detailsmap from strings to anyOptional

Metadata for the agent.

tagslist of stringsOptional

Metadata tags.

tidstringOptional

The unique identifier of the transaction that processed this step.

messageslist of objectsOptional

The messages generated during this step.

1 curl https://app.letta.com/v1/steps/step_id \ 2 -H "Authorization: Bearer <token>"

1 { 2 "id": "id", 3 "origin": "origin", 4 "provider_id": "provider_id", 5 "job_id": "job_id", 6 "provider_name": "provider_name", 7 "model": "model", 8 "context_window_limit": 1, 9 "completion_tokens": 1, 10 "prompt_tokens": 1, 11 "total_tokens": 1, 12 "completion_tokens_details": { 13 "key": "value" 14 }, 15 "tags": [ 16 "tags" 17 ], 18 "tid": "tid", 19 "messages": [ 20 { 21 "role": "assistant", 22 "created_by_id": "created_by_id", 23 "last_updated_by_id": "last_updated_by_id", 24 "created_at": "2024-01-15T09:30:00Z", 25 "updated_at": "2024-01-15T09:30:00Z", 26 "id": "message-123e4567-e89b-12d3-a456-426614174000", 27 "content": [ 28 { 29 "type": "text", 30 "text": "text" 31 } 32 ], 33 "agent_id": "agent_id", 34 "model": "model", 35 "name": "name", 36 "tool_calls": [ 37 { 38 "id": "id", 39 "function": { 40 "arguments": "arguments", 41 "name": "name" 42 }, 43 "type": "function" 44 } 45 ], 46 "tool_call_id": "tool_call_id", 47 "step_id": "step_id" 48 } 49 ] 50 }

Retrieve Step

Path parameters

Response

Errors

1	curl https://app.letta.com/v1/steps/step_id \
2	-H "Authorization: Bearer <token>"

1	{
2	"id": "id",
3	"origin": "origin",
4	"provider_id": "provider_id",
5	"job_id": "job_id",
6	"provider_name": "provider_name",
7	"model": "model",
8	"context_window_limit": 1,
9	"completion_tokens": 1,
10	"prompt_tokens": 1,
11	"total_tokens": 1,
12	"completion_tokens_details": {
13	"key": "value"
14	},
15	"tags": [
16	"tags"
17	],
18	"tid": "tid",
19	"messages": [
20	{
21	"role": "assistant",
22	"created_by_id": "created_by_id",
23	"last_updated_by_id": "last_updated_by_id",
24	"created_at": "2024-01-15T09:30:00Z",
25	"updated_at": "2024-01-15T09:30:00Z",
26	"id": "message-123e4567-e89b-12d3-a456-426614174000",
27	"content": [
28	{
29	"type": "text",
30	"text": "text"
31	}
32	],
33	"agent_id": "agent_id",
34	"model": "model",
35	"name": "name",
36	"tool_calls": [
37	{
38	"id": "id",
39	"function": {
40	"arguments": "arguments",
41	"name": "name"
42	},
43	"type": "function"
44	}
45	],
46	"tool_call_id": "tool_call_id",
47	"step_id": "step_id"
48	}
49	]
50	}