How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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._

Treasure Data Parent Segment Configurations API is one of 67 APIs that Treasure Data publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Parent Segment Configurations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 12 operations across 9 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 5 base URLs: https://api-cdp.treasuredata.com, https://api-cdp.treasuredata.co.jp, https://api-cdp.eu01.treasuredata.com, https://api-cdp.ap02.treasuredata.com, https://api-cdp.ap03.treasuredata.com.

12 operations 9 paths 26 schemas 1 DELETE8 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.treasuredata.com/v3/bulk_loads
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Treasure Data Parent Segment Configurations API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (TdApikeyAuth).

Paths & Operations 12

Across 9 paths, the API surfaces 12 operations — 1 DELETE, 8 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Parent Segment Configurations 12

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 inte…

GET
/audiences
Retrieve list of parent segment configurations
audiences#index → 2004004014034044XX5XX
POST
/audiences
Create new parent segment configuration
audiences#create body → 4004014034044XX5XX
GET
/audiences/{audienceId}
Retrieve parent segment configuration by ID
audiences#show 1 param → 2004004014034044XX5XX
PUT
/audiences/{audienceId}
Update parent segment configuration
audiences#update 1 param body → 4004014034044XX5XX
DELETE
/audiences/{audienceId}
Delete parent segment configuration
audiences#delete 1 param → 404
GET
/audiences/{audienceId}/attributes
Retrieve list of audience attributes
audience_attributes#index 1 param → 2004004014034044XX5XX
GET
/audiences/{audienceId}/behaviors
Retrieve list of audience behaviors
audience_behaviors#index 2 params → 2004004014034044XX5XX
POST
/audiences/{audienceId}/run
Run workflow to (re)generate parent segment
audiences#run 1 param → 2004004014034044XX5XX
GET
/audiences/{audienceId}/executions
Retrieve list of executions using audienceId
audiences#executions 1 param → 2004004014034044XX5XX
GET
/audiences/{audienceId}/statistics
Retrieve population statistics audience
audiences#statistics 3 params → 2004004014034044XX5XX
GET
/audiences/{audienceId}/sample_values
Retrieve list of values for a parent segment configuration's attribute
audiences#sample_values 4 params → 2004004014034044XX5XX
GET
/audiences/{audienceId}/behaviors/{audienceBehaviorId}/sample_values
Retrieve list of sample values for a parent segment configuration's behavior
audiences_behaviors#sample_values 5 params → 2004004014034044XX5XX

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are Audience (28 properties), ComposableAudience (21 properties), AudienceAttributeWithVisibility (14 properties), ComposableAudienceAttribute (12 properties). Each schema is shown below with its type and property counts.

ScheduleType
string
ComposableAudienceBehavior
object
Exactly one of federatedQueryConfigId or connectionId must be provided.
12 properties 6 required
Execution
SampleValuesPayload
array
array of tuple of sample values
AudienceBehaviorSchema
object
3 properties 3 required
AudienceAttributeWithVisibility
object
14 properties 8 required
User
object
3 properties
ComposableAudienceAttribute
object
Exactly one of federatedQueryConfigId or connectionId must be provided.
12 properties 6 required
Statistic
array
AudienceExecution
AudienceMasterAttribute
object
Attribute of master table, not attribute tables. Similar to AudienceAttribute but some properties are null
7 properties 3 required
ComposableAudience
object
A composable audience for zero-copy segments using CDW tables via federated queries (Snowflake) or direct connections (Databricks). Exactly one of federatedQue…
21 properties 4 required
Audience
object
An audience handles a Master Segment and a related Master Segment Config.
28 properties 1 required
AudienceFilter
object
2 properties 2 required
AudienceBehaviorSchemaWithVisibility
object
6 properties 3 required
CustomerGroupBehaviorSchema
object
3 properties 3 required
AudienceBehavior
object
11 properties 7 required
CustomerGroupAttribute
object
7 properties 7 required
AudienceBehaviorWithVisibility
object
10 properties 7 required
ColumnType
string
Type of the column
ExecutionCore
object
5 properties 5 required
AudienceAttribute
object
9 properties 9 required
CustomerGroupBehavior
object
6 properties 7 required
Error
object
2 properties 2 required
CustomerGroup
object
A group of customers within an audience
9 properties 5 required
AudienceMaster
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

treasure-data-parent-segment-configurations-api-openapi.yml Raw ↑

Other APIs Treasure Data publishes across the network.

Treasure Data Bulk Loads API
Treasure Data User API
Treasure Data System API
Treasure Data Postback API
Treasure Workflow API
Treasure Data Bulk Import API
Treasure Data Bulk Loads API
Treasure Data Connectors API
Treasure Data Databases API
Treasure Data Jobs API
Treasure Data SSO API
Treasure Data System API
Where this information came from

This is an independent, third-party profile of Treasure Data Parent Segment Configurations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.