Skip to main content
Version: 2025-12-18

Creates a job to complete multiple target groups

POST 
/demand/accounts/:account_id/projects/:project_id/batch-jobs/complete-fielding-runs-by-target-group-id

Creates an asynchronous job to complete a list of target groups.

This action will immediately close the specified target groups to new respondents, regardless of whether their completes goals or end dates have been reached. This endpoint returns a Location header containing the URL you can use to track the job's status.

Request​

Responses​

The job was created successfully. Poll the URL in the Location header to track its status.

Response Headers
    traceparent

    The traceparent header carries the trace ID and parent span ID, as defined by the W3C Trace Context specification. It's used to trace a single request as it moves through multiple services.

    tracestate

    The tracestate header complements the traceparent header by carrying vendor-specific trace information. This allows different services to add their own data to a trace.

    location

    Contains the URL where a new resource can be found, often returned with a 201 Created response. It follows the format defined in RFC 7231.

    Example: /demand/accounts/101/projects/01BTGNYV6HRNK8K8VKZASZCFP0/batch-jobs/complete/01BTGNYV6HRNK8K8VKZASZCFP1