Growth Studio OpenAPI接入文档 · Folder Management

文件夹归属由 API Key 绑定的 workspace 决定。调用方不能传入或覆盖 workspace_id;允许创建同名文件夹,每次创建都会得到不同的 folder_id。

创建文件夹

POST /openapi/v1/folders
Content-Type: application/json
Authorization: Bearer <API_KEY>
curl --request POST \
  "${BASE_URL}/openapi/v1/folders" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{"name":"September campaign"}'

HTTP 状态码:201 Created

{
  "folder_id": "627410861853514292",
  "request_id": "create-folder-001"
}

name 为文件夹名称;folder_id 是新建文件夹的 64 位 ID,必须按字符串保存和传输。

获取文件夹列表

GET /openapi/v1/folders
Authorization: Bearer <API_KEY>
curl --request GET \
  "${BASE_URL}/openapi/v1/folders" \
  --header "Authorization: Bearer ${API_KEY}"

HTTP 状态码:200 OK

{
  "folders": [
    {"folder_id": "627410861853514292", "name": "September campaign"}
  ],
  "request_id": "list-folders-001"
}

folders 是当前 API Key 绑定 workspace 内、未删除的文件夹对象数组;空列表返回 []。每个对象含 folder_id 和 name。列表按最新创建在前返回,调用方不应依赖顺序。

错误码与限流