Skip to main content
GET
Get an agent

Authorizations

X-Api-Key
string
header
default:LANGSMITH_API_KEY
required

Path Parameters

agent_id
string<uuid>
required

Managed Deep Agent ID.

Query Parameters

include_files
boolean
default:false

Include the raw file map in the agent response. Accepted truthy values are true and 1.

Response

Agent returned.

id
string<uuid>
name
string
description
string
owner_id
string<uuid>
created_at
string<date-time>
updated_at
string<date-time>
permissions
object

Agent visibility and sharing configuration. When omitted on create, defaults to personal identity, tenant visibility, and read tenant access.

runtime
object
extras
object
access_level
enum<string>

Caller access level for this agent.

Available options:
READ,
RUN,
WRITE
is_owner
boolean

Whether the authenticated caller owns this agent.

backend
object
revision
string

Revision token for the latest file tree commit.

instructions
string

Deprecated alias echoed alongside system_prompt for backwards compatibility.

tools
object
subagents
object[]
skills
object[]
files
object

Raw file map for paths not covered by typed fields. Keys are relative file paths. Setting a typed field and the corresponding files entry returns 422.

system_prompt
string

Agent system prompt parsed from AGENTS.md.