Treasure Data

Treasure Data Folders API

Folders are containers in which you can organize information. Nested folders offer flexible organization controls. Large volumes of data and application assets can be organized into multi-nested folders by categories such as geographical markets, brands, and business functions. Granular permissions can be set for each folder to ensure security.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /audiences/{audienceId}/folders Create a segment folder in a parent segment · Create new segment folder #
Ask an LLM
“Can I organize segments into a new folder under a parent segment?”
“What does a new segment folder need besides a name?”
Tell an agent
Create segment folder {name} described as {description} in parent segment {audienceId}.
Add a folder {name} with description {description} to audience {audienceId}.
GET /audiences/{audienceId}/folders/{folderId} Get a segment folder in a parent segment · Retrieve single segment folder #
Ask an LLM
“Can I look up one segment folder within a parent segment?”
“What name and description does a given segment folder have?”
Tell an agent
Show segment folder {folderId} in parent segment {audienceId}.
Get folder {folderId} of audience {audienceId}.
PATCH /audiences/{audienceId}/folders/{folderId} Update a segment folder (legacy) · Update segment folder (legacy) #
Ask an LLM
“Can I rename a segment folder in legacy Audience Studio?”
“Is it possible to change a legacy folder's description?”
Tell an agent
Rename segment folder {folderId} in parent segment {audienceId} to {name}.
Set the description of legacy folder {folderId} in audience {audienceId} to {description}.
DELETE /audiences/{audienceId}/folders/{folderId} Delete a segment folder (legacy) · Delete segment folder (legacy) #
Ask an LLM
“Can I delete a segment folder in legacy Audience Studio?”
“What removes a folder from a parent segment in the legacy studio?”
Tell an agent destructive · confirm first
Delete segment folder {folderId} from parent segment {audienceId}.
Remove legacy folder {folderId} in audience {audienceId}.
POST /audiences/{audienceId}/folders/{folderId}/put_in Move segments into a folder (legacy) · Move segment into folder (legacy) #
Ask an LLM
“Can I move existing segments into a folder in legacy Audience Studio?”
“What files segments under a different folder in the legacy studio?”
Tell an agent
Move segments into folder {folderId} of parent segment {audienceId}.
Put segments into legacy folder {folderId} in audience {audienceId}.
GET /entities/by-folder/{folderId} List everything under a folder · Retrieve list of objects under specified folder #
Ask an LLM
“What segments, funnels, models and tokens live under a folder?”
“Can I control how deep into child folders the listing goes, and include segment rules?”
Tell an agent
List objects under folder {folderId} to depth {depth}.
List contents of folder {folderId} to depth {depth} with rules {with_rule}.
POST /entities/folders Create a folder via the entities API · Create folder #
Ask an LLM
“Can I create a folder in the current Audience Studio through the entities API?”
“What attributes define a new folder entity?”
Tell an agent
Create an entities-API folder with attributes {attributes}.
Create a folder entity with attributes {attributes} under {relationships}.
GET /entities/folders/{id} Get a folder by entity ID · Retrieve folder by ID #
Ask an LLM
“Can I fetch a folder using only its entity ID?”
“What does the entities API return for one folder?”
Tell an agent
Get entities-API folder {id}.
Fetch folder entity {id}.
PATCH /entities/folders/{id} Update a folder via the entities API · Update folder #
Ask an LLM
“Can I rename or move a folder entity by its ID?”
“Which folder attributes can the entities API change?”
Tell an agent
Patch entities-API folder {id} with attributes {attributes}.
Move folder entity {id} under {relationships}.
DELETE /entities/folders/{id} Delete a folder via the entities API · Delete folder #
Ask an LLM
“Can I delete a folder by its entity ID in the current Audience Studio?”
“What removes a folder entity?”
Tell an agent destructive · confirm first
Delete entities-API folder {id}.
Remove folder entity {id}.

Documentation

📖
Documentation
https://docs.treasure.ai/apis/td-api
📖
APIReference
https://docs.treasure.ai/apis/td_api_v3-public
📖
GettingStarted
https://docs.treasure.ai/apis/td-api
📖
Documentation
https://docs.treasure.ai/apis/audience-api/overview
📖
APIReference
https://docs.treasure.ai/apis/td_cdp_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/audience-api
📖
Documentation
https://docs.treasure.ai/apis/llm-api
📖
APIReference
https://docs.treasure.ai/apis/llm_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/llm-api
📖
APIReference
https://docs.treasure.ai/apis/dwh_integration_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/dwh-integration-api/quickstart
📖
GettingStarted
https://docs.treasure.ai/apis/p13n-api
📖
GettingStarted
https://docs.treasure.ai/apis/postback-v2/quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-folders-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/treasure-data:treasure-data-folders-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

treasure-data-folders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: cdp-api Folders API
  description: All of the CDP APIs are organized around REST - if you've interacted with a RESTful API already, many of the concepts will be familiar to you. All API calls to CDP API should be made to the following endpoints depending on the region. For historical reasons there are REST API endpoints and JSON:API endpoints. JSON:API endpoints are located under "/entities".
  termsOfService: https://www.treasuredata.com/terms/
  version: 1.0.0
servers:
- url: https://api-cdp.treasuredata.com
- url: https://api-cdp.treasuredata.co.jp
- url: https://api-cdp.eu01.treasuredata.com
- url: https://api-cdp.ap02.treasuredata.com
- url: https://api-cdp.ap03.treasuredata.com
tags:


# --- truncated at 32 KB (114 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-folders-api-openapi.yml