---
title: "Explain one candidate through preflight context"
method: POST
path: "/candidate-explain"
---

# Explain one candidate through preflight context

`POST /candidate-explain`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/candidate-explain`
- Auth: HTTP bearer

## Request body

- object
  - `candidate_id` string, required
  - `operator_id` string

## Response `200`

Candidate explanation

- object
  - `schema_version` 'ads_quant.cross_platform_candidate_preflight_api.v1', required
  - `status` 'candidate_preflight_preview_created', required
  - `operator_id` string
  - `candidate_id` string, required
  - `candidate` object, required
  - `action_packet` object
  - `network_prior` object
  - `preflight_preview` object, required
  - `promotion_gate` object
  - `draft_created` false, required
  - `hosted_auth_context` object, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)