Folders

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.

Operations

Create new segment folder

Request

Create a new parent segment folder.

Security

TdApikeyAuth

Path

audienceIdinteger, (int64)required

Master segment ID

Bodyapplication/json

Segment Folder to create

namestringrequired

descriptionstringrequired

curl -i -X POST \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/folders' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string"
  }'

Responses

Returns the segment folder which was created

Bodyapplication/json

idstring[1-9][0-9]*

audienceIdstring[1-9][0-9]*

ID of the parent audience. For composable folders this carries the composable audience id; the complete-vs-composable discriminator lives on the parent audience entity, not on the folder.

namestring

descriptionstring or null

createdAtstring, (date-time)

updatedAtstring, (date-time)

createdByUser (object) or (NullValue (object or null))

One of:

updatedByUser (object) or (NullValue (object or null))