Skip to content
Letta Platform Letta Platform Letta Docs
Sign up
API Reference
Agents

Export Agent

GET/v1/agents/{agent_id}/export

Export the serialized JSON representation of an agent, formatted with indentation.

Path ParametersExpand Collapse
agent_id: string
Query ParametersExpand Collapse
conversation_id: optional string

Conversation ID to export. If provided, uses messages from this conversation instead of the agent’s global message history.

Deprecatedmax_steps: optional number
scrub_messages: optional boolean

If True, excludes all messages from the export. Useful for sharing agent configs without conversation history.

Deprecateduse_legacy_format: optional boolean

If True, exports using the legacy single-agent ‘v1’ format with inline tools/blocks. If False, exports using the new multi-entity ‘v2’ format, with separate agents, tools, blocks, files, etc.

Export Agent

curl https://api.letta.com/v1/agents/$AGENT_ID/export \
    -H "Authorization: Bearer $LETTA_API_KEY"
"string"
Returns Examples
"string"