Call a Claude Managed Agent hosted on the Claude Platform from a Sim workflow. Select a Claude Platform account, agent, and environment, then send the task message.

Optional inputs attach credential vaults, a memory store with read or write access and usage instructions, files, and metadata tags. The Run session (create, send, wait for reply) operation waits for the reply and returns final text and a session ID, with token usage when available, for downstream processing and cost tracking. Outputs from the other operations depend on the selected action. Session actions also create, inspect, interrupt, archive, update, or delete sessions; read events; and submit custom-tool results or confirmation responses. File attachments are supported for cloud environments.

Use the block

Run or create a session with a Claude Platform account, agent, and environment. Optionally attach vaults, a memory store, files, and metadata. The Run session operation waits for the agent’s reply and returns final text and a session ID, with token usage when available. Outputs from other operations depend on the selected action.

Actions

Managed Agent Run Session

Open a Claude Platform Managed Agent session and return the assistant response as text.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to run the agent with.
agent	string	Yes	Managed-agent id inside the linked Claude workspace.
environment	string	Yes	Environment id inside the linked Claude workspace.
environmentType	string	No	Environment execution model hint ('cloud' | 'self_hosted'); the actual type is re-resolved server-side for routing.
userMessage	string	Yes	The user message to send to the Managed Agent.
vaults	array	No	Zero or more vault ids for MCP tool auth.
vaultsAck	boolean	No	Acknowledgement that the author may use the attached vaults.
memoryStoreId	string	No	Optional Agent Memory Store id.
memoryAccess	string	No	Memory store access mode: 'read_write' (default) or 'read_only'.
memoryInstructions	string	No	Per-attachment guidance for how the agent should use the memory store.
files	array	No	File attachments (cloud envs only), as [{fileId, mountPath?}].
sessionParameters	object	No	Key/value session metadata forwarded to the session.

Output

Parameter	Type	Description
content	string	Final assistant text from the Managed Agent session.
sessionId	string	Anthropic session id (for logs / linking).
inputTokens	number	Cumulative input tokens for the session.
outputTokens	number	Cumulative output tokens for the session.

Managed Agent Create Session

Create a Claude Platform Managed Agent session and return its id without waiting for a reply.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
agent	string	Yes	Managed-agent id inside the linked Claude workspace.
environment	string	Yes	Environment id inside the linked Claude workspace.
environmentType	string	No	Environment execution model hint ('cloud' | 'self_hosted').
userMessage	string	No	Optional first message; seeds initial_events and starts the agent immediately.
vaults	array	No	Zero or more vault ids for MCP tool auth.
vaultsAck	boolean	No	Acknowledgement that the author may use the attached vaults.
memoryStoreId	string	No	Optional Agent Memory Store id.
memoryAccess	string	No	Memory store access mode: 'read_write' (default) or 'read_only'.
memoryInstructions	string	No	Per-attachment guidance for how the agent should use the memory store.
files	array	No	File attachments (cloud envs only), as [{fileId, mountPath?}].
sessionParameters	object	No	Key/value session metadata forwarded to the session.

Output

Parameter	Type	Description
sessionId	string	Anthropic session id (sesn_...).
started	boolean	True when a first message was seeded, so the agent is already running.

Managed Agent Send Message

Send a user message to an existing Claude Platform Managed Agent session.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.
userMessage	string	Yes	The user message to send to the session.

Output

Parameter	Type	Description
sessionId	string	The session the message was sent to.
sent	boolean	True when the event was accepted by the API.

Managed Agent Get Session

Read a Managed Agent session: status, stop reason, token usage, metadata, and any tool calls awaiting approval.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.

Output

Parameter	Type	Description
sessionId	string	The session that was read.
status	string	Session status — 'idle', 'running', 'rescheduling', or 'terminated'.
stopReason	string	Why the session last stopped, e.g. 'end_turn' or 'requires_action'.
requiresAction	boolean	True when the session is waiting on a tool confirmation or custom tool result. If this is true while pendingTools is empty, the session is blocked but the API named no blocking events — surface it rather than treating the session as done.
pendingTools	json	Blocking tool calls — [{id, eventType, kind, name, input}]. Route by kind: 'confirmation' ids go to Respond To Tool Confirmation, 'custom_tool_result' ids go to Respond To Custom Tool.
metadata	json	Session metadata.
title	string	Session title.
inputTokens	number	Cumulative input tokens.
outputTokens	number	Cumulative output tokens.

Managed Agent List Events

Read a Managed Agent session's event history and the agent's reply text.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.
eventTypes	array	No	Optional event-type filter, e.g. ['agent.message']. Omit to return every event.
limit	number	No	Maximum events to return, keeping the most recent (default 500).

Output

Parameter	Type	Description
sessionId	string	The session that was read.
events	json	Session events, oldest first.
count	number	Number of events returned.
assistantText	string	Concatenated text of every persisted agent.message, in order.
truncated	boolean	True when the limit was hit and older events were dropped.

Managed Agent Update Session

Update a Managed Agent session's title or metadata.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.
title	string	No	New session title.
sessionParameters	object	No	Replacement metadata map (replaces all stored metadata, not merged). Leaving it empty leaves the stored metadata unchanged — use clearMetadata to remove it.
clearMetadata	boolean	No	Removes all of the session's stored metadata. Overrides any map supplied above.

Output

Parameter	Type	Description
sessionId	string	The session that was updated.
updated	boolean	True when the update was accepted.
metadata	json	Metadata after the update.
title	string	Title after the update.

Managed Agent Interrupt Session

Stop a running Managed Agent session; it stays usable afterwards.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.

Output

Parameter	Type	Description
sessionId	string	The session that was interrupted.
interrupted	boolean	True when the interrupt was accepted.

Managed Agent Respond To Tool Confirmation

Allow or deny the tool calls a Managed Agent session is waiting on before it can continue.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.
toolUseIds	array	Yes	Blocking tool-use EVENT ids, from Get Session pendingTools[].id where kind is 'confirmation' (not toolu_ ids).
decision	string	Yes	'allow' to let the tools run, or 'deny' to reject them.
denyMessage	string	No	Reason surfaced to the agent. Only sent when the decision is deny.

Output

Parameter	Type	Description
sessionId	string	The session that was answered.
decision	string	The decision applied — 'allow' or 'deny'.
confirmedToolUseIds	json	The tool-use event ids that were answered.

Managed Agent Respond To Custom Tool

Return the result of a custom tool a Managed Agent session is waiting on so it can continue.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.
customToolUseId	string	Yes	The custom tool-use EVENT id being answered, from Get Session pendingTools[].id where kind is 'custom_tool_result'.
result	string	Yes	The tool's output, returned to the agent as text.
isError	boolean	No	Mark the result as a failure so the agent can adjust its approach.

Output

Parameter	Type	Description
sessionId	string	The session that was answered.
answeredToolUseId	string	The custom tool-use event id that was answered.

Managed Agent Archive Session

Archive a Managed Agent session, preserving its history. Not reversible.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.

Output

Parameter	Type	Description
sessionId	string	The session that was archived.
archived	boolean	True when the archive was accepted.

Managed Agent Delete Session

Permanently delete a Managed Agent session, its events, and its sandbox. Not reversible.

Inputs and outputs

Input

Parameter	Type	Required	Description
credential	string	Yes	Claude Platform credential (Anthropic workspace API key) to act with.
sessionId	string	Yes	Anthropic session id (sesn_...) to act on.

Output

Parameter	Type	Description
sessionId	string	The session that was deleted.
deleted	boolean	True when the delete was accepted.