Retrieve Step

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

1 { 2 "id": "foo", 3 "origin": "foo", 4 "provider_id": "foo", 5 "job_id": "foo", 6 "agent_id": "foo", 7 "provider_name": "foo", 8 "provider_category": "foo", 9 "model": "foo", 10 "model_endpoint": "foo", 11 "context_window_limit": 42, 12 "completion_tokens": 42, 13 "prompt_tokens": 42, 14 "total_tokens": 42, 15 "completion_tokens_details": {}, 16 "tags": [ 17 "foo" 18 ], 19 "tid": "foo", 20 "trace_id": "foo", 21 "messages": [ 22 { 23 "role": "assistant", 24 "created_by_id": "foo", 25 "last_updated_by_id": "foo", 26 "created_at": "foo", 27 "updated_at": "foo", 28 "id": "message-123e4567-e89b-12d3-a456-426614174000", 29 "agent_id": "foo", 30 "model": "foo", 31 "content": [ 32 { 33 "type": "omitted_reasoning" 34 } 35 ], 36 "name": "foo", 37 "tool_calls": [ 38 { 39 "id": "foo", 40 "function": { 41 "arguments": "foo", 42 "name": "foo" 43 }, 44 "type": "foo" 45 } 46 ], 47 "tool_call_id": "foo", 48 "step_id": "foo", 49 "otid": "foo", 50 "tool_returns": [ 51 { 52 "status": "success", 53 "stdout": [ 54 "foo" 55 ], 56 "stderr": [ 57 "foo" 58 ] 59 } 60 ], 61 "group_id": "foo", 62 "sender_id": "foo", 63 "batch_item_id": "foo" 64 } 65 ] 66 }

Get a step by ID.

Path parameters

step_idstringRequired

Response

Successful Response

idstring

The id of the step. Assigned by the database.

originstring or null

The surface that this agent step was initiated from.

provider_idstring or null

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

job_idstring or null

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

agent_idstring or null

The ID of the agent that performed the step.

provider_namestring or null

The name of the provider used for this step.

provider_categorystring or null

The category of the provider used for this step.

modelstring or null

The name of the model used for this step.

model_endpointstring or null

The model endpoint url used for this step.

context_window_limitinteger or null

The context window limit configured for this step.

completion_tokensinteger or null

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

prompt_tokensinteger or null

The number of tokens in the prompt during this step.

total_tokensinteger or null

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

completion_tokens_detailsobject or null

Metadata for the agent.

tagslist of strings or null

Metadata tags.

tidstring or null

The unique identifier of the transaction that processed this step.

trace_idstring or null

The trace id of the agent step.

messageslist of objects or null

The messages generated during this step.

Path parameters

Headers

Response