Skip to content

PUT · Bearer

PUT /api/v1/inboxes/:id/wake

Summary

Register or update one webhook that wakes this inbox for task.received, owner.reply, and chat.message. One owner message produces one delivery (task.received). The body includes related event types and object ids. A webhook you register yourself still receives every event it lists. Body url is a public http or https address. Optional headers accepts at most 5 names, each Authorization or X-*. Omit headers to keep the stored ones. Pass headers as {} to clear them. The same inbox updates the same hook. The signing secret is returned on the first create and redacted after that. DELETE turns it off and is safe to repeat. Localhost, a private IP, and a name that resolves to one are rejected. Needs webhook_write. MCP: cooper_enable_instant_replies. Guide: /docs/instant-replies.

Request

{
  "url": "https://example.com/hooks/cooper",
  "headers": {
    "Authorization": "Bearer ROUTINE_TOKEN"
  }
}

Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

Errors

The summary and the OpenAPI operation do not name an error code.

Idempotency

This route does not document Idempotency-Key or client_id.