GET
/api/public/v1/vault-folders

List Vault folders

Every folder the token can reach, flat — assemble the hierarchy from `parentId`, where a null one sits at the Vault root. `systemType` marks the folders the platform manages itself: EMPLOYEE_AGREEMENTS, PROJECT_ATTACHMENTS, MY_DOWNLOADS, and the CHANNEL and DM folders that mirror a Threads conversation. Those last two are visible only to that conversation’s members, which is why this list can legitimately be shorter for one person than another.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Settings → Company → API, and to a teammate under Employee → Permissions.

vault:admin
GETExample request
curl
curl -X GET "https://www.pxb.app/api/public/v1/vault-folders" \
  -H "Authorization: Bearer your_access_token"
200Example response
json
{
  "message": "Vault folders retrieved successfully!",
  "content": {
    "folders": [
      {
        "id": "vdoc_0001",
        "name": "Board",
        "parentId": null,
        "systemType": null,
        "isSystem": false,
        "conversationId": null
      }
    ]
  }
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Vault
/vault