---
title: "Build Ads Quant Workbench copilot context"
method: POST
path: "/workbench-context"
---

# Build Ads Quant Workbench copilot context

`POST /workbench-context`

## 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/workbench-context`
- Auth: HTTP bearer

Read-only bridge for Ads Quant Workbench to pass the selected customer/account/candidate/action context into GravityMind AI without bypassing account scope.

## Request body

- object
  - `operator_id` string
  - `customer_name` string
  - `platform` string
  - `account_id` string
  - `candidate_id` string
  - `action_id` string
  - `limit` integer

## Response `200`

Workbench context

- object
  - `status` 'workbench_context_ready', required
  - `operator_id` string, required
  - `customer_name` string
  - `platform` string
  - `account_id` string
  - `candidate_id` string
  - `action_id` string
  - `account_scope` object, required
  - `candidate_count` integer, required
  - `candidate_count_meaning` object
  - `candidates` object[], required
  - `copilot_context` object, required
  - `hosted_auth_context` object, required
  - `writes_platform` false, 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)