Agent inboxes

Get an inbox

GET/v1/agent/inbox/:id

Returns an inbox's settings, counts and wake metrics.

Parameters

Path parameters1

idstringRequired

Destination ID (dst_…).

Returns

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

GETGet an inbox

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

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

200Response

{
  "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
  }
}

{"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}}