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.

agent_idstringOptional

The ID of the agent that performed the step.

provider_namestringOptional

The name of the provider used for this step.

modelstringOptional

The name of the model used for this step.

model_endpointstringOptional

The model endpoint url 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.

trace_idstringOptional

The trace id of the agent 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 "agent_id": "agent_id", 7 "provider_name": "provider_name", 8 "model": "model", 9 "model_endpoint": "model_endpoint", 10 "context_window_limit": 1, 11 "completion_tokens": 1, 12 "prompt_tokens": 1, 13 "total_tokens": 1, 14 "completion_tokens_details": { 15 "key": "value" 16 }, 17 "tags": [ 18 "tags" 19 ], 20 "tid": "tid", 21 "trace_id": "trace_id", 22 "messages": [ 23 { 24 "role": "assistant", 25 "created_by_id": "created_by_id", 26 "last_updated_by_id": "last_updated_by_id", 27 "created_at": "2024-01-15T09:30:00Z", 28 "updated_at": "2024-01-15T09:30:00Z", 29 "id": "message-123e4567-e89b-12d3-a456-426614174000", 30 "content": [ 31 { 32 "type": "text", 33 "text": "text" 34 } 35 ], 36 "agent_id": "agent_id", 37 "model": "model", 38 "name": "name", 39 "tool_calls": [ 40 { 41 "id": "id", 42 "function": { 43 "arguments": "arguments", 44 "name": "name" 45 }, 46 "type": "function" 47 } 48 ], 49 "tool_call_id": "tool_call_id", 50 "step_id": "step_id", 51 "otid": "otid", 52 "tool_returns": [ 53 { 54 "status": "success" 55 } 56 ] 57 } 58 ] 59 }

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	"agent_id": "agent_id",
7	"provider_name": "provider_name",
8	"model": "model",
9	"model_endpoint": "model_endpoint",
10	"context_window_limit": 1,
11	"completion_tokens": 1,
12	"prompt_tokens": 1,
13	"total_tokens": 1,
14	"completion_tokens_details": {
15	"key": "value"
16	},
17	"tags": [
18	"tags"
19	],
20	"tid": "tid",
21	"trace_id": "trace_id",
22	"messages": [
23	{
24	"role": "assistant",
25	"created_by_id": "created_by_id",
26	"last_updated_by_id": "last_updated_by_id",
27	"created_at": "2024-01-15T09:30:00Z",
28	"updated_at": "2024-01-15T09:30:00Z",
29	"id": "message-123e4567-e89b-12d3-a456-426614174000",
30	"content": [
31	{
32	"type": "text",
33	"text": "text"
34	}
35	],
36	"agent_id": "agent_id",
37	"model": "model",
38	"name": "name",
39	"tool_calls": [
40	{
41	"id": "id",
42	"function": {
43	"arguments": "arguments",
44	"name": "name"
45	},
46	"type": "function"
47	}
48	],
49	"tool_call_id": "tool_call_id",
50	"step_id": "step_id",
51	"otid": "otid",
52	"tool_returns": [
53	{
54	"status": "success"
55	}
56	]
57	}
58	]
59	}