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; 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 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

Search by folder name

Example:

"Call"

page
string
default:1

Page number (starts from 1)

Example:

"1"

limit
string
default:20

Number of records per page (default: 20, max: 50)

Example:

"20"

export
boolean
default:false

Set to true to export all data without pagination

Example:

true

Response

Organization folders returned successfully.

success
enum<boolean>
required
Available options:
true
error
enum<boolean>
required
Available options:
false
statusCode
integer
required
Example:

200

message
string
required
Example:

"Success"

data
object
required
timestamp
string<date-time>
required