Agent inboxes

Listen for readiness

GET/v1/agent/inbox/:id/ready

A server-sent events stream that tells an agent with no public address when its inbox has work. Carries counts only, never event data.

Parameters

Path parameters1

idstringRequired

Destination ID (dst_…).

Returns

200A JSON object describing the result.Errors return error and message; see Errors and limits.

GETListen for readiness

curl "https://api.getensue.com/v1/agent/inbox/dst_…/ready" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/agent/inbox/dst_…/ready", {
  method: "GET",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://api.getensue.com/v1/agent/inbox/dst_…/ready",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

Returns a JSON object describing the result.