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. Each folder also carries organization_id, is_deleted, createdAt, updatedAt, an organization object with id and title, and agentCount, the number of agents in the folder that are not deleted. agentCount is returned by this list only, not by Get Organization Folder. The response also includes the applied page and limit values; results are always paginated, so request further pages until one comes back short. 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.400 Bad Requestmeanspageorlimitdoes not start with a number or is outside the supported range (a value such as2.5or5abcis read as its leading whole number), for exampleLimit must be between 1 and 50. 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.