メインコンテンツへスキップ
GET
/
agents
/
folders
/
{id}
Get Folder
curl --request GET \
  --url https://api.cartesia.ai/agents/folders/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'
{
  "id": "<string>",
  "parent_id": "<string>",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "agents": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "documents": [
    {
      "id": "<string>",
      "name": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ]
}

承認

Authorization
string
header
必須

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

ヘッダー

Cartesia-Version
enum<string>
必須

API version header.

利用可能なオプション:
2026-03-01
:

"2026-03-01"

パスパラメータ

id
string
必須

The ID of the folder.

レスポンス

id
string
必須

The ID of the folder.

parent_id
string | null
必須

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

name
string
必須

The folder's name.

created_at
string<date-time>
必須

When the folder was created.

agents
FolderAgentSummary · object[]
必須

Agents that have access to this folder.

documents
FolderDocumentSummary · object[]
必須

Documents inside this folder.