Agent inboxes

List inboxes

GET/v1/agent/inbox

Returns the inboxes the key can use, with waiting and leased counts.

Parameters

This endpoint takes no parameters.

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

GETList inboxes

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

const res = await fetch("https://api.getensue.com/v1/agent/inbox", {
  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",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "items": [
    {
      "id": "dst_7q1c…",
      "name": "billing-agent",
      "type": "inbox",
      "status": "active",
      "created": 1762761600000,
      "lease_seconds": 300,
      "waiting": 3,
      "leased": 1,
      "oldest_at": 1762761700000,
      "wake": {
        "enabled": false
      }
    }
  ]
}

{"items":[{"id":"dst_7q1c…","name":"billing-agent","type":"inbox","status":"active","created":1762761600000,"lease_seconds":300,"waiting":3,"leased":1,"oldest_at":1762761700000,"wake":{"enabled":false}}]}