Skip to main content
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 the folders 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 Unauthorized means the API key is missing or invalid.
  • 404 Not Found means the authenticated organization no longer exists.
  • A validation error means page or limit is outside the supported range. Correct the query before retrying.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

Case-insensitive folder name search.

Example:

"Sales"

page
integer
default:1

Page number starting from 1.

Required range: x >= 1
limit
integer
default:20

Results per page. Maximum 50.

Required range: 1 <= x <= 50

Response

Organization folders returned successfully.

folders
object[]
required
page
integer
required
Example:

1

limit
integer
required
Example:

20