Organization Folders
List Organization Folders
List DialNexa organization folders with search and pagination so integrations can resolve folder IDs before reading or organizing agents.
GET
List Organization Folders
Read only
List organization folders to resolve the folder IDs and names available in the authenticated workspace. The operation returns active folders only and sorts them from oldest to newest.
When to list organization folders
- Resolve a folder ID before filtering or organizing agents.
- Build a folder picker without hard-coding workspace-specific IDs.
- Confirm that a folder exists before reading its details.
Query parameters
Verify the result
Use thefolders array to read each folder’s id and name. The response also includes the applied page and limit values. An empty folders array means no active folder matched the request.
Errors and recovery
401 Unauthorizedmeans the API key is missing or invalid.404 Not Foundmeans the authenticated organization no longer exists.- A validation error means
pageorlimitis outside the supported range. Correct the query before retrying.
Related endpoints
- Get Organization Folder: read one folder by ID.
- List Agents: list the agents that can be organized into folders.
- Agent folders: organize agents in the dashboard.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Case-insensitive folder name search.
Example:
"Sales"
Page number starting from 1.
Required range:
x >= 1Results per page. Maximum 50.
Required range:
1 <= x <= 50List Organization Folders