AgentConnect
Agents

List an assistant-mode agent’s items

Reads the items in the agent’s ledger from its daemon: section=open (the default) lists active and waiting items, closed lists done and dropped ones, most recently updated first, at most 100. Each item carries its title, status, what counts as done, when the agent noted it should check next, where it was asked and the places its followers follow it from — never who follows it or what was said. Anyone who can view the agent may read it; nothing is stored by this call.

GET
/v1/orgs/{orgId}/agents/{id}/assistant/items

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

section?string
Default"open"

Value in

  • "open"
  • "closed"
limit?integer
Range1 <= value <= 100
Default100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/assistant/items"
{  "items": [    {      "id": "string",      "title": "string",      "status": "active",      "doneWhen": "string",      "nextCheck": "2019-08-24T14:15:22Z",      "origin": {        "platform": "string",        "channel": "string"      },      "places": [        {          "platform": "string",          "channel": "string"        }      ],      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "truncated": true}