Treasure Data

Treasure Data Parent Segment Configurations API

Defining a data model for customer data is done by defining parent segments. Parent segments give you an ability to build a single view of a customer, including capturing all interactions, such as attributes and behaviors associated with your brand. In parent segments, you unify your customer data. When the customer data is unified, you can create customer segments without writing any SQL queries. You can personalize customer communications and conversations of any size and in any channel. _Treasure Data is making an effort to use more inclusive language in its product, content, and customer solutions. As we gradually make the move to replace insensitive language beginning in our UI, you may continue to see parent segments in the UI, for example, referenced as master segment in portions of Treasure Data APIs._

GitHub OpenAPI
Business capability
Customer Segmentation Management BC-420.20

Operations 12

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

GET /audiences List parent segment configurations · Retrieve list of parent segment configurations #
Ask an LLM
“Which parent segments are configured in my Treasure Data account?”
“Can I see every parent segment with its schedule, owner and population at once?”
Tell an agent
List all my parent segment configurations.
Show every parent segment along with its schedule and who created it.
POST /audiences Create a parent segment configuration · Create new parent segment configuration #
Ask an LLM
“How do I set up a new parent segment for building audiences?”
“Can a new parent segment be put on a schedule in a particular timezone when I create it?”
Tell an agent
Create a new parent segment named {name}.
Create parent segment {name} with a {scheduleType} schedule in timezone {timezone}.
GET /audiences/{audienceId} Get one parent segment configuration · Retrieve parent segment configuration by ID #
Ask an LLM
“What is configured on a specific parent segment?”
“Can I pull up a single parent segment's master table, attributes and behaviors by its ID?”
Tell an agent
Show parent segment {audienceId}.
Get the full configuration of parent segment {audienceId}.
PUT /audiences/{audienceId} Update a parent segment configuration · Update parent segment configuration #
Ask an LLM
“Can I rename an existing parent segment without touching its attributes and behaviors?”
“What happens to attributes and behaviors if I include the master table when editing a parent segment?”
Tell an agent
Rename parent segment {audienceId} to {name}.
Change the description of parent segment {audienceId} named {name} to {description}.
DELETE /audiences/{audienceId} Delete a parent segment configuration · Delete parent segment configuration #
Ask an LLM
“How do I remove a parent segment I no longer use?”
“Is deleting a parent segment configuration permanent?”
Tell an agent destructive · confirm first
Delete parent segment {audienceId}.
Remove the parent segment configuration {audienceId} from my account.
GET /audiences/{audienceId}/attributes List a parent segment's attributes · Retrieve list of audience attributes #
Ask an LLM
“Which customer attributes are defined on a parent segment?”
“Can I see the attributes of a parent segment and how sensitive ones are shown?”
Tell an agent
List the attributes of parent segment {audienceId}.
Show me what attributes parent segment {audienceId} exposes.
GET /audiences/{audienceId}/behaviors List a parent segment's behaviors · Retrieve list of audience behaviors #
Ask an LLM
“What behavior tables are attached to a parent segment?”
“Can I list only the realtime behaviors of a parent segment?”
Tell an agent
List the behaviors of parent segment {audienceId}.
Show behaviors of parent segment {audienceId} with realtime set to {realtime}.
POST /audiences/{audienceId}/run Regenerate a parent segment · Run workflow to (re)generate parent segment #
Ask an LLM
“How do I refresh a parent segment so it picks up new data?”
“Can I kick off the workflow that rebuilds a parent segment on demand?”
Tell an agent
Run the workflow to regenerate parent segment {audienceId}.
Rebuild parent segment {audienceId} now.
GET /audiences/{audienceId}/executions List a parent segment's workflow runs · Retrieve list of executions using audienceId #
Ask an LLM
“Did the last parent segment refresh succeed or fail?”
“Where can I see the history of workflow executions for one parent segment?”
Tell an agent
List the workflow executions for parent segment {audienceId}.
Show me whether recent runs of parent segment {audienceId} succeeded.
GET /audiences/{audienceId}/statistics Get a parent segment's population history · Retrieve population statistics audience #
Ask an LLM
“How has the number of profiles in a parent segment changed day by day?”
“Can I get population counts for a parent segment between two dates?”
Tell an agent
Show the daily population history of parent segment {audienceId}.
Get population statistics for parent segment {audienceId} from {from} to {to}.
GET /audiences/{audienceId}/sample_values Sample values of a parent segment attribute · Retrieve list of values for a parent segment configuration's attribute #
Ask an LLM
“What kind of values does an attribute column in my parent segment contain?”
“Can I preview a limited number of sample values for one attribute column?”
Tell an agent
Show sample values of attribute column {column} in parent segment {audienceId}.
Get up to {limit} sample values for attribute {column} of parent segment {audienceId}.
GET /audiences/{audienceId}/behaviors/{audienceBehaviorId}/sample_values Sample values of a parent segment behavior · Retrieve list of sample values for a parent segment configuration's behavior #
Ask an LLM
“What do the values in a behavior column look like before I build a segment on it?”
“Can I see sample data from one behavior of a parent segment?”
Tell an agent
Show sample values of column {column} in behavior {audienceBehaviorId} of parent segment {audienceId}.
Get {limit} sample values from behavior {audienceBehaviorId} column {column} in parent segment {audienceId}.

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-parent-segment-configurations-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-parent-segment-configurations-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-parent-segment-configurations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: cdp-api Parent Segment Configurations 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 (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-parent-segment-configurations-api-openapi.yml