Agents - Atlan Trident

22 operations on client.agents, including agents.sessions, agents.traces, agents.versions. Path parameters come first, positionally; the request body is last, as a plain object. Method names are snake_case in Python and camelCase in TypeScript, and resource names follow the same rule.

result = client.agents.adopt_identity_secret_custody(agent_id, body)

const result = await client.agents.adoptIdentitySecretCustody(agent_id, body);

Operations

Call	Route	Does
`client.agents.adopt_identity_secret_custody(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/identity/custody`	Move an agent’s existing client secret into Gateway custody
`client.agents.aggregate(body)`	`POST /agent/v1/agents/aggregate`	Aggregate agents
`client.agents.archive(agent_id)`	`POST /agent/v1/agents/{agent_id}/archive`	Archive an agent
`client.agents.create(body)`	`POST /agent/v1/agents`	Create an agent
`client.agents.delete_profile_image(agent_id)`	`DELETE /agent/v1/agents/{agent_id}/profile-image`	Remove an agent’s profile image
`client.agents.get(agent_id)`	`GET /agent/v1/agents/{agent_id}`	Get an agent
`client.agents.get_profile_image(agent_id)`	`GET /agent/v1/agents/{agent_id}/profile-image`	Get an agent’s profile image
`client.agents.list()`	`GET /agent/v1/agents`	List agents
`client.agents.revoke_identity(agent_id)`	`POST /agent/v1/agents/{agent_id}/identity/revoke`	Revoke an agent’s API key
`client.agents.rotate_identity(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/identity/rotate`	Rotate one of an agent’s credentials
`client.agents.search(body)`	`POST /agent/v1/agents/search`	Search agents
`client.agents.update(agent_id, body)`	`PATCH /agent/v1/agents/{agent_id}`	Update an agent
`client.agents.upload_profile_image(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/profile-image`	Upload an agent’s profile image
`client.agents.sessions.create(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/sessions`	Trigger an agent run
`client.agents.sessions.list(agent_id)`	`GET /agent/v1/agents/{agent_id}/sessions`	List an agent’s sessions
`client.agents.traces.get(agent_id, trace_id)`	`GET /agent/v1/agents/{agent_id}/traces/{trace_id}`	Read one trace for an agent
`client.agents.traces.list(agent_id)`	`GET /agent/v1/agents/{agent_id}/traces`	List traces for an agent
`client.agents.traces.list_spans(agent_id, trace_id)`	`GET /agent/v1/agents/{agent_id}/traces/{trace_id}/spans`	List spans in a trace for an agent
`client.agents.traces.query_stats(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/traces/stats/query`	Query trace statistics for an agent
`client.agents.versions.append(agent_id, body)`	`POST /agent/v1/agents/{agent_id}/versions`	Publish a new agent version
`client.agents.versions.get(agent_id, version_ordinal)`	`GET /agent/v1/agents/{agent_id}/versions/{version_ordinal}`	Get one agent version
`client.agents.versions.list(agent_id)`	`GET /agent/v1/agents/{agent_id}/versions`	List an agent’s versions

Operations

Client structure, call shapes, and errors.

Errors and retries

What the SDK raises, and which calls are safe to retry.