FruxonDocs
ApiAgent topics

Get the agent's inbox landscape — the focus structure used to order the topic timeline.

Pass `participantId` to scope to one participant (returns 0 or 1 inbox; empty when the pair has never been routed — this is a read, so it never lazily creates an inbox). Omit it to get the agent's full landscape, one inbox per participant. Each inbox carries the focal topic id, the focus stack (home-first), the suspended-topic ids, and the home topic id.

GET
/v1/tenants/{tenant}/agents/{agent}/inbox

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

participantId?string

Optional participant filter.

Formatuuid

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/inbox"
{
  "inboxes": [
    {
      "participantId": "00000000-0000-0000-0000-000000000000",
      "focalTopicId": "00000000-0000-0000-0000-000000000000",
      "focusStack": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "suspendedTopicIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "homeTopicId": "00000000-0000-0000-0000-000000000000"
    }
  ]
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}