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

Treasure Data Folders 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 Folders. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 10 operations across 6 paths, and defines 97 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.

10 operations 6 paths 97 schemas 2 DELETE3 GET2 PATCH3 POST

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 Folders API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (TdApikeyAuth).

Paths & Operations 10

Across 6 paths, the API surfaces 10 operations — 2 DELETE, 3 GET, 2 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Folders 10

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

POST
/audiences/{audienceId}/folders
Create new segment folder
1 param body → 200
GET
/audiences/{audienceId}/folders/{folderId}
Retrieve single segment folder
2 params → 200
PATCH
/audiences/{audienceId}/folders/{folderId}
Update segment folder (legacy)
2 params body → 200
DELETE
/audiences/{audienceId}/folders/{folderId}
Delete segment folder (legacy)
2 params → 200
POST
/audiences/{audienceId}/folders/{folderId}/put_in
Move segment into folder (legacy)
2 params body → 2004004014034044XX5XX
GET
/entities/by-folder/{folderId}
Retrieve list of objects under specified folder
3 params → 200
POST
/entities/folders
Create folder
body → 200
GET
/entities/folders/{id}
Retrieve folder by ID
1 param → 200
PATCH
/entities/folders/{id}
Update folder
1 param body → 200
DELETE
/entities/folders/{id}
Delete folder
1 param → 200400403404409

Schemas 97

The contract defines 97 schemas that model the data the API accepts and returns. The most detailed are PredictiveSegmentJsonApiResourceAttr (15 properties), ActivationTemplateFieldPropertiesLocked (13 properties), SegmentFolderReadRepresentation (8 properties), JourneyStageJsonApiResource (8 properties). Each schema is shown below with its type and property counts.

MlSolutionJsonApiResource
object
4 properties 4 required
partial_v5_rule.yaml-v5IonRule-attributeNameValue
object
1 property 1 required
Execution
partial_v5_rule.yaml-v5IonRule-filter
ActivationTemplateSyndicationBehaviorProperties
object
6 properties
MlSolutionCoreAttributes
object
5 properties 5 required
RepeatUnit
string
Setting an activation repetition cycle such as "day" or "week".
RelationshipsFolderJsonApiResource
object
1 property
JourneyStep
objectnull
1 property
partial_v5_rule.yaml-v5IonRule-columnFilter
DeprecatedScheduleType
string
Deprecated. Old parameter for setting schedule type. See/Use RepeatUnit instead.
EntitiesGetByFolderJsonApiResponse
object
2 properties 2 required
StartAt
stringnull
cdp-api will fill some value for old syndications with ScheduleType is not NoneType. '%Y-%M-%DT%h:%m:%s' is expected.
JourneyWaitStep
object
JourneyAbTestStep
object
7 properties 4 required
ActivationTemplateFieldPropertiesLocked
object
activation template field properties locked
13 properties
JourneyWaitStepDaysOfTheWeek
object
6 properties 5 required
EntitiesGetFolderJsonApiResponse
object
2 properties 2 required
PredictiveSegmentAccuracy
numbernull
Accuracy for trained model evaluated on initial training.
RelationshipsSegmentJsonApiResource
object
1 property
JourneyJsonApiResource
object
4 properties 4 required
Error
object
2 properties 2 required
BatchSegmentJsonApiResource
object
4 properties 4 required
JsonApiBadParameterError
object
5 properties 3 required
JourneyWaitStepConditionPath
object
7 properties 1 required
partial_v5_rule.yaml-v5IonRule-ionRule
object
4 properties 2 required
MlSolutionAttributes
UserJsonApiResource
object
3 properties 3 required
partial_v5_rule.yaml-v5IonRule-valueLimit
object
3 properties 2 required
partial_v5_rule.yaml-v5IonRule-valueLeftValue
FunnelJsonApiResource
object
4 properties 4 required
JourneyJumpStep
object
3 properties 3 required
MlSolutionCltvAttributes
object
5 properties 3 required
RelationshipsUserJsonApiResource
object
1 property
partial_v5_rule.yaml-v5IonRule-localDuration
object
8 properties
JsonApiPermissionError
object
4 properties 3 required
partial_v5_rule.yaml-v5IonRule-orFilter
object
2 properties 2 required
JourneyDecisionPointBranch
object
4 properties 2 required
partial_v5_rule.yaml-v5IonRule-duration
JsonApiMaskedValueError
object
5 properties 5 required
JourneyWaitStepDate
object
6 properties 5 required
partial_v5_rule.yaml-v5IonRule-aggregationValue
object
4 properties 3 required
RelationshipsBatchSegmentJsonApiResource
object
1 property
PredictiveSegmentGradeThresholds
array
Given the items [a, b, c], they must meet the condition a = b = c
partial_v5_rule.yaml-v5IonRule-valueCondition
object
6 properties 5 required
JourneyEndStep
objectnull
2 properties
partial_v5_rule.yaml-v5IonRule-unit
string
partial_v5_rule.yaml-v5IonRule-andFilter
object
2 properties 2 required
JourneyDecisionPointStep
object
3 properties 3 required
JourneyActivationStep
object
4 properties 3 required
PredictiveSegmentJsonApiResource
object
4 properties 4 required
SegmentFolderCreateRepresentation
object
2 properties 2 required
JourneyCriteria
objectnull
4 properties 2 required
JourneyMergeStep
object
3 properties 1 required
partial_v5_rule.yaml-v5IonRule-valueOperator
TokenJsonApiResource
object
4 properties 4 required
SegmentFolderUpdateRepresentation
object
2 properties
PredictiveSegmentJsonApiResourceAttr
object
15 properties
User
object
3 properties
JourneyWaitStepDuration
object
6 properties 5 required
RelationshipsRealtimeSegmentJsonApiResource
object
1 property
StringExpression
object
2 properties 1 required
partial_v5_rule.yaml-v5IonRule-referenceCondition
partial_v5_rule.yaml-v5IonRule-timeframeOperator
RealtimeSegmentJsonApiResource
object
4 properties 4 required
RepeatFrequency
integer
Setting an activation repeat frequency. Currently, it is set only when the repeat unit is "minute". If the repeat unit is "minute", the interval is set in minu…
partial_realtime_journey.yaml-RealtimePersonalizationByFolderResource
object
4 properties
PredictiveSegmentAreaUnderRocCurve
numbernull
Evaluation score for the model. See also https://en.wikipedia.org/wiki/ReceiveroperatingcharacteristicAreaunderthecurve
partial_v5_rule.yaml-v5IonRule-valueArrayMatching
ColumnExpression
object
3 properties 1 required
JourneyJumpTarget
object
5 properties 2 required
partial_v5_rule.yaml-v5IonRule-customerGroupAttributeValue
object
2 properties 2 required
SegmentFolderReadRepresentation
object
8 properties
RelationshipsFolderNullableJsonApiResource
object
1 property
FolderPermissions
object
2 properties
MlSolutionRfmAttributes
object
6 properties 3 required
partial_realtime_journey.yaml-RealtimeJourneyByFolderResource
object
4 properties
ExecutionCore
object
5 properties 5 required
JsonApiConflictError
object
4 properties 3 required
partial_realtime_journey.yaml-RealtimeJourneyState
string
ActivationTemplateJsonApiResource
object
4 properties
JsonApiNotFoundError
object
3 properties 3 required
FolderJsonApiResource
object
4 properties 4 required
Columns
array
Syndication column detail. Basic syntax is {"column": "aliasname", "source": {...}}. source accepts various definitions. See ColumnExpression/StringExpression…
partial_v5_rule.yaml-v5IonRule
NullValue
objectnull
1 property
JourneyStageJsonApiResource
object
8 properties 1 required
FunnelStageJsonApiResource
object
4 properties 1 required
JourneyWaitStepCondition
object
4 properties 4 required
EntitiesFolderUpdateRepresentation
object
4 properties
JsonApiValidationError
object
5 properties 5 required
ActivationTemplateFieldProperties
object
activation template field properties
1 property 1 required
RepeatSubFrequency
array
Parameter for more detailed frequency settings. Values are array of integers. Currently, this parameter is only valid for repeat unit "week". For multiple days…
JourneyAbTestVariant
object
6 properties 3 required
partial_v5_rule.yaml-v5IonRule-valueConditionSet
object
4 properties 2 required
ComposableSegmentJsonApiResource
object
4 properties 4 required
FunctionExpression

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

treasure-data-folders-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 Folders 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.