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。列表按最新创建在前返回,调用方不应依赖顺序。