Trigger audience unload

Trigger an actual unload for an audience, writing its results to S3. The audience must be in a completed state. Once triggered, use the status endpoint to poll for completion.

The project is required twice over: send project_id in the request body (required), and scope the call with the project_id query parameter or X-Project-Id header like the other audience operations.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Audience ID.

Query Params
uuid

Project ID (UUID). Every audience operation except GET /api/v1/audiences/schema is scoped to a project: send this parameter or the X-Project-Id header. Without either the request returns 400 with project_id is required.

Body Params
uuid
required

Project ID.

Headers
uuid

Project ID (UUID). Equivalent to the project_id query parameter; send one or the other.

Responses

400

Invalid request.

401

Missing or invalid authentication.

403

Forbidden.

404

Audience not found.

409

Conflict (audience already unloading or not in a valid state).

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json