Skip to main content
Version: 2025-12-18

Completes a fielding run

POST 

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

Immediately completes a live or scheduled fielding run, setting its status to completed.

This action will close the target group to new respondents, regardless of whether its completes goal or end date has been reached.

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 this resource.

Request

Responses

The request to complete the fielding run was accepted successfully.

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.