---
title: "Upsert operator-provided business context"
method: POST
path: "/business-context/upsert"
---

# Upsert operator-provided business context

`POST /business-context/upsert`

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

Writes local Ads Quant business context only. It never writes ad platforms, and it rejects raw OAuth or API credential fields.

## Request body

- object
  - `request_id` string, required: Idempotency key for this business context intake.
  - `operator_id` string
  - `operator` string
  - `confirmation` string
  - `mode` 'merge' | 'replace'
  - `refresh_local_artifacts` boolean
  - `records` object[], required

## Response `200`

Business context upsert result

- object
  - `schema_version` 'ads_quant.business_context_records_action.v1', required
  - `status` 'business_context_records_upserted', required
  - `request_id` string, required
  - `operator` string
  - `record_count` integer, required
  - `mode` 'merge' | 'replace', required
  - `local_business_context_config_written` boolean
  - `refresh_local_artifacts` boolean
  - `refresh_results` object[]
  - `hosted_auth_context` object, required
  - `writes_platform` false

---

[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)