Background Agents

Invoke Background Agent

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.

post/api/background-agents/{id}/invoke

Request

  • Base URL: https://app.withwillow.ai
  • URL: https://app.withwillow.ai/api/background-agents/{id}/invoke
  • Auth: HTTP bearer

Path parameters

idstring required

The ID of the background agent to invoke

Request body

session_keystring required

Stable correlation key for the conversation (e.g. a ticket ID). Reusing a key resumes the existing session.

messagestring required

The message to send to the agent

Example request

{
  "session_key": "ticket-4821",
  "message": "A new ticket was opened. Please investigate."
}

Response

Message delivered to the agent

Changes

No recorded changes to this operation across all 1 revision of this API.