Skip to main content
Version: 2025-12-18

Job to launch a draft target group

POST 
/demand/accounts/:account_id/projects/:project_id/target-groups/:target_group_id/fielding-run-jobs/launch-from-draft

Creates an asynchronous job to launch a draft target group, setting its status to live.

A 201 Created response indicates that the job was successfully created, not that the target group is live. To check the outcome, you must poll the job status URL returned in the Location header. You can find the details for the status endpoint here: Get launch job 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/target-groups/01BTGNYV6HRNK8K8VKZASZCFP1/fielding-run-jobs/launch-from-draft/01BTGNYV6HRNK8K8VKZASZCFP1