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.

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