Background Agents

Create, list, update, sync, and invoke background agents, and inspect their platform sessions. Background agents run on external platforms (Claude Managed Agents, AWS AgentCore, or your own runtime) and call tools through the Willow gateway. Requires `admin:read` for reading and `admin:write` for mutations.

📄️Create Background Agent

Creates a new background agent in your organization.

📄️Delete Background Agent

Deletes a background agent by ID.

📄️Get Background Agent by Slug

Returns a single background agent by its slug.

📄️Get Session Events

Returns the conversation log (event stream) for a single session of this agent, along with the session record.

📄️Get Background Agent

Returns a single background agent by ID, including its capabilities, platform configuration, and sync state.

📄️Invoke Background Agent

Sends a message to the agent on its external platform and starts (or resumes) a conversation.

📄️List Background Agent Sessions

Lists the agent's conversation sessions on its external platform. Sessions created via the invoke endpoint (or webhooks) are enriched with their local `session_key` correlation.

📄️List Background Agents

Returns a list of all background agents in your organization.

📄️Rotate Background Agent Secret

Rotates the agent's gateway secret and returns the new plaintext secret.

📄️Sync Background Agent

Syncs the agent to its external platform (Claude Managed Agents or AWS AgentCore). Creates or updates the external agent definition, uploads enabled skills, and stores fresh gateway credentials on the platform side.

📄️Update Background Agent

Updates an existing background agent by ID.