Skip to main content

Invoke Background Agent

POST 
/api/background-agents/:id/invoke

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

Conversations are correlated by session_key — a stable identifier you choose for the entity or thread (for example, a ticket ID or a pull request URL). Sending another message with the same session_key resumes the existing conversation; a new key starts a new session.

The agent must be active and synced to the claude-managed-agents or aws-agentcore platform.

Request​

Responses​

Message delivered to the agent