Skip to main content
Version: 2025-12-18

Launches fielding run immediately

POST 

/demand/accounts/:account_id/projects/:project_id/target-groups/:target_group_id/fielding-runs/:fielding_run_id/launch-now

Immediately launches a scheduled fielding run, setting its status to live.

This action updates the start_fielding_at timestamp to the current time. The end_fielding_at timestamp is also recalculated to preserve the original fielding duration.

This endpoint uses optimistic locking. You must provide the fielding run's current version in the If-Match header. You can get this value from the ETag header of a GET request for the resource.

Request

Responses

The fielding run was launched successfully. The response body contains the updated start and end times.

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.

    etag

    The ETag header provides a unique identifier that represents the current version of a resource. It's used for caching and to prevent concurrent modification issues.