Skip to main content
Register Claude Managed Agents and inspect the Agent, session, event, and trace records reported from their external runtime. Atlan does not trigger or execute Claude Managed Agent runs.
Run Claude Managed Agents in your configured Claude environment. Keep runtime credentials and execution controls there.

​
Prerequisites

  • An Agent Registry agent ID for the runtime to report against.
  • Access to the Claude environment where the Agent runs.
  • OAuth access to the Atlan gateway.
  • Permission to read the agent and create its sessions.

​
Record a completed Claude run

  1. Run the Claude Managed Agent in its configured external environment.
  2. Create the Agent record if it does not already exist.
  3. Upload the final session through the Agent category in the API reference, including the original execution timestamp, outcome, stop reason, and usage.
  4. Retrieve session events to inspect provider-native activity. Upload session_message records only when your harness captures a transcript.
Keep credentials out of application source and request URLs.

​
Expected result

Atlan stores the completed session and exposes its reported events and traces. Creating that record does not cause the Claude Managed Agent to run.

​
Verification

Retrieve the session and confirm its Agent, outcome, and execution timestamp match the external run. Inspect its event stream and traces through the Agent API reference before using its output downstream.

​
Limitations

  • Atlan does not start, execute, or stream Claude Managed Agent workloads.
  • A session cannot be edited or deleted after creation.
  • The documentation playground remains disabled; run requests from an approved environment.