FLfloqer
ackDB

List the caller's segment folders

Returns the caller's folders in rail order (#470). Folders are a PERSONAL filing layer — you only ever see your own — so every route here requires a signed-in user; a service/static-API-key call has no rail and gets 400. entityKind narrows the COUNTS only, never the folder list: a folder holding nothing in the current grain still renders empty, because hiding it would make folders vanish and reappear as you switch tabs.

get/api/v1/ackdb/observe/segment-folders

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Query parameters

entityKind'company' | 'contact' | 'person'

Grain to scope each folder's segmentCount to. Omit to count every grain.

Response

The caller's folders, ordered by position.

Example response

{
  "data": [
    {
      "id": "01JA0B1C2D3E4F5G6H7J8K9M0N",
      "name": "Q3 Enterprise Push",
      "ownerEmail": "rep@acme.com",
      "segmentCount": 4
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.