Skip to main content
GET
Get Folder

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-03-01
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Path Parameters

id
string
required

The ID of the folder.

Response

id
string
required

The ID of the folder.

parent_id
string | null
required

The ID of the parent folder, or null for top-level folders.

name
string
required

The folder's name.

created_at
string<date-time>
required

When the folder was created.

agents
FolderAgentSummary · object[]
required

Agents that have access to this folder.

documents
FolderDocumentSummary · object[]
required

Documents inside this folder.