Retrieve list of segment folders

Request

Retrieve a list of segment folders based on a parent segment's identifier.

Security

TdApikeyAuth

Path

audienceIdinteger, (int64)required

Master segment ID

curl -i -X GET \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/folders' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Retrieves a list of segment folders.

N.B. that createdAt can be null, meaning that it is not known which user created the folder.

N.B. that updatedAt can be null, meaning that is is not known which user last updated the folder.

Bodyapplication/json

Array [

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

One of:

]

Response

[
  {
    "id": "string",
    "audienceId": "string",
    "name": "string",
    "description": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "createdBy": { … },
    "updatedBy": { … }
  }
]