Skip to main content
GET
Get Organization Folder
Read only Get an organization folder by ID to confirm its current name and that it belongs to the authenticated workspace. Deleted folders are not returned.

Before you begin

Call List Organization Folders to obtain a current folder ID. Do not reuse an ID from a different workspace.

Verify the result

A successful response includes the folder id, name, organization_id, and timestamps. Compare the returned id with the requested value before using it in another operation.

Errors and recovery

  • 401 Unauthorized means the API key is missing or invalid.
  • 404 Not Found means the folder does not exist, was deleted, or belongs to another workspace. List folders again instead of retrying the same ID.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Organization folder ID.

Example:

"fld_abc123xyz789"

Response

Organization folder returned successfully.

id
string
required
Example:

"fld_abc123xyz789"

organization_id
string
required
Example:

"org_abc123xyz789"

name
string
required
Maximum string length: 35
Example:

"Sales Agents"

is_deleted
boolean
required
Example:

false

created_at
string<date-time>
required
updated_at
string<date-time>
required