AdBuyMCP · 195 operations

REST API reference

Request contracts come from the API's registered routes and existing validators. Endpoint pages describe authentication, parameters, headers and responses. Success payloads without a full model are explicitly marked in the specification.

Download OpenAPI 3.1 →

Authenticate your first request

Private REST requests require a short-lived human sign-in session with this API's audience. There is no self-service API key. MCP assistants use their separate OAuth connection.

Session credentials, workspace checks and troubleshooting →

Agent

GET/api/v1/agent/actions

Read consequential agent action contracts

POST/api/v1/agent/actions/prepare

Prepare an exact agent action for review

POST/api/v1/agent/approvals/{id}/abandon

Run agent / approvals / abandon

POST/api/v1/agent/approvals/{id}/resolve

Resolve an exact agent approval

GET/api/v1/agent/exceptions

Read agent / exceptions

POST/api/v1/agent/exceptions/{id}/resolve

Run agent / exceptions / resolve

POST/api/v1/agent/mandates/{id}/revoke

Run agent / mandates / revoke

GET/api/v1/agent/missions

Read agent / missions

POST/api/v1/agent/missions

Run agent / missions

GET/api/v1/agent/missions/{id}

Read agent / missions

POST/api/v1/agent/missions/{id}/close

Run agent / missions / close

POST/api/v1/agent/missions/{id}/mandates

Run agent / missions / mandates

GET/api/v1/agent/missions/{id}/runs

Read agent / missions / runs

POST/api/v1/agent/missions/{id}/runs

Run agent / missions / runs

GET/api/v1/agent/runs/{id}

Read agent / runs

POST/api/v1/agent/runs/{id}/advance

Run agent / runs / advance

POST/api/v1/agent/runs/{id}/approvals

Run agent / runs / approvals

POST/api/v1/agent/runs/{id}/approvals/resolve

Resolve explicitly selected agent approvals

POST/api/v1/agent/runs/{id}/decisions

Run agent / runs / decisions

POST/api/v1/agent/runs/{id}/evidence

Run agent / runs / evidence

POST/api/v1/agent/runs/{id}/exceptions

Run agent / runs / exceptions

POST/api/v1/agent/runs/{id}/finish

Run agent / runs / finish

POST/api/v1/agent/runs/{id}/resume

Run agent / runs / resume

POST/api/v1/agent/runs/{id}/steps

Run agent / runs / steps

POST/api/v1/agent/steps/{id}/complete

Run agent / steps / complete

POST/api/v1/agent/steps/{id}/execution/resolve

Run agent / steps / execution / resolve

Assets

GET/api/v1/assets/{jobId}

Read asset job status

POST/api/v1/assets/{jobId}/resolve

Resolve an uncertain asset production job

POST/api/v1/assets/{jobId}/retry

Run assets / retry

GET/api/v1/assets/pricing

Read asset pricing and model licensing

Audit

GET/api/v1/audit

Read audit

Auth

GET/api/v1/auth/context

Read the verified request identity

Billing

GET/api/v1/billing/spend-locks

Read billing / spend locks

POST/api/v1/billing/spend-locks/{lockId}/resolve

Run billing / spend locks / resolve

POST/api/v1/billing/spend-locks/{lockId}/stops/{stopId}/resolve

Run billing / spend locks / stops / resolve

GET/api/v1/billing/statements

Read or download billing statements

GET/api/v1/billing/summary

Read spend, fees and wallet balances

POST/api/v1/billing/topup

Fund the advertiser wallet

GET/api/v1/billing/topup/requests/{requestId}

Inspect a committed funding request

POST/api/v1/billing/topup/requests/{requestId}/reconcile

Recover a funding Checkout reference

GET/api/v1/billing/topup/status

Read wallet funding status

POST/api/v1/billing/webhook

Receive signed Stripe settlement events

Brand lift studies

GET/api/v1/brand-lift-studies/{studyId}

Read brand lift studies

PATCH/api/v1/brand-lift-studies/{studyId}

Update brand lift studies

POST/api/v1/brand-lift-studies/{studyId}/approvals

Run brand lift studies / approvals

GET/api/v1/brand-lift-studies/{studyId}/artifacts

Read brand lift studies / artifacts

POST/api/v1/brand-lift-studies/{studyId}/artifacts

Run brand lift studies / artifacts

GET/api/v1/brand-lift-studies/{studyId}/artifacts/{artifactId}/content

Read brand lift studies / artifacts / content

POST/api/v1/brand-lift-studies/{studyId}/attempts/{attemptId}/resolve

Run brand lift studies / attempts / resolve

POST/api/v1/brand-lift-studies/{studyId}/cancellation-request

Run brand lift studies / cancellation request

POST/api/v1/brand-lift-studies/{studyId}/cancellation-resolution

Run brand lift studies / cancellation resolution

POST/api/v1/brand-lift-studies/{studyId}/close-local

Run brand lift studies / close local

POST/api/v1/brand-lift-studies/{studyId}/draft

Run brand lift studies / draft

POST/api/v1/brand-lift-studies/{studyId}/launch

Run brand lift studies / launch

POST/api/v1/brand-lift-studies/{studyId}/preview

Run brand lift studies / preview

POST/api/v1/brand-lift-studies/{studyId}/quote-request

Run brand lift studies / quote request

POST/api/v1/brand-lift-studies/{studyId}/quotes

Run brand lift studies / quotes

GET/api/v1/brand-lift-studies/{studyId}/results

Read brand lift studies / results

POST/api/v1/brand-lift-studies/{studyId}/results/refresh

Run brand lift studies / results / refresh

POST/api/v1/brand-lift-studies/{studyId}/settlements

Run brand lift studies / settlements

POST/api/v1/brand-lift-studies/{studyId}/tracking

Run brand lift studies / tracking

Buyer

GET/api/v1/buyer/context

Prepare evidence and next actions for an MCP media buyer

GET/api/v1/buyer/sessions

List this agent client’s buyer conversations

POST/api/v1/buyer/sessions

Create an agent-owned buyer conversation

GET/api/v1/buyer/sessions/{id}

Read the durable buyer session and current turn fence

POST/api/v1/buyer/sessions/{id}/cancel

Cancel buyer reasoning and invalidate stale tool dispatch

POST/api/v1/buyer/sessions/{id}/erase

Erase this conversation’s text and resource links

POST/api/v1/buyer/sessions/{id}/turns

Claim one idempotent buyer turn

POST/api/v1/buyer/sessions/{id}/turns/{requestId}/complete

Settle the current buyer reasoning turn

POST/api/v1/buyer/sessions/{id}/voice-attempts

Record an idempotent outbound voice bootstrap attempt

POST/api/v1/buyer/sessions/{id}/voice-attempts/{requestId}/complete

Record the observed outcome of a voice bootstrap

Campaigns

GET/api/v1/campaigns

Read campaigns

GET/api/v1/campaigns/{id}

Read campaigns

GET/api/v1/campaigns/{id}/attempts

Inspect durable provider attempts

POST/api/v1/campaigns/{id}/attempts/{attemptId}/resolve

Resolve an uncertain provider attempt

GET/api/v1/campaigns/{id}/bookings

Read or request managed supplier bookings

POST/api/v1/campaigns/{id}/bookings

Read or request managed supplier bookings

GET/api/v1/campaigns/{id}/brand-lift-studies

Read campaigns / brand lift studies

POST/api/v1/campaigns/{id}/brand-lift-studies

Run campaigns / brand lift studies

GET/api/v1/campaigns/{id}/brand-lift-study-catalogs

Read campaigns / brand lift study catalogs

PATCH/api/v1/campaigns/{id}/creatives

Update campaigns / creatives

GET/api/v1/campaigns/{id}/dead-letters

Read campaigns / dead letters

POST/api/v1/campaigns/{id}/dead-letters/{deadLetterId}/resolve

Run campaigns / dead letters / resolve

GET/api/v1/campaigns/{id}/delivery

Read reconciled campaign delivery

GET/api/v1/campaigns/{id}/insights

Read campaigns / insights

GET/api/v1/campaigns/{id}/journeys

Read campaigns / journeys

POST/api/v1/campaigns/{id}/launch

Launch or stage an approved campaign

PATCH/api/v1/campaigns/{id}/lines/{lineId}/conversion-goal

Update campaigns / lines / conversion goal

GET/api/v1/campaigns/{id}/lines/{lineId}/conversion-goals

Read campaigns / lines / conversion goals

POST/api/v1/campaigns/{id}/lines/{lineId}/creatives/{creativeId}/approval

Run campaigns / lines / creatives / approval

GET/api/v1/campaigns/{id}/lines/{lineId}/provider-spend-artifacts/{artifactId}

Read campaigns / lines / provider spend artifacts

POST/api/v1/campaigns/{id}/lines/{lineId}/provider-spend-reconciliations

Run campaigns / lines / provider spend reconciliations

GET/api/v1/campaigns/{id}/live-test-grants

Read campaigns / live test grants

POST/api/v1/campaigns/{id}/live-test-grants

Run campaigns / live test grants

POST/api/v1/campaigns/{id}/live-test-grants/{grantId}/revoke

Run campaigns / live test grants / revoke

GET/api/v1/campaigns/{id}/measurement

Read campaign measurement and evidence quality

POST/api/v1/campaigns/{id}/optimize

Run campaigns / optimize

GET/api/v1/campaigns/{id}/outcomes/health

Read campaigns / outcomes / health

POST/api/v1/campaigns/{id}/outcomes/import

Run campaigns / outcomes / import

POST/api/v1/campaigns/{id}/pause

Pause or request stopping a campaign

POST/api/v1/campaigns/{id}/prove-it

Evaluate geo-lift evidence

POST/api/v1/campaigns/{id}/provider-spend-artifacts

Run campaigns / provider spend artifacts

GET/api/v1/campaigns/{id}/provider-spend-reconciliations

Read campaigns / provider spend reconciliations

GET/api/v1/campaigns/{id}/readiness

Inspect campaign readiness and buying blockers

GET/api/v1/campaigns/{id}/report

Download the campaign report

POST/api/v1/campaigns/{id}/resume

Resume an eligible campaign

POST/api/v1/campaigns/{id}/staged-cancellation

Run campaigns / staged cancellation

POST/api/v1/campaigns/{id}/sync-audience

Run campaigns / sync audience

GET/api/v1/campaigns/{id}/tracking

Read campaigns / tracking

PATCH/api/v1/campaigns/{id}/tracking/{channel}

Update campaigns / tracking

POST/api/v1/campaigns/{id}/workflow/{runId}/acknowledge

Run campaigns / workflow / acknowledge

Connections

GET/api/v1/connections

Read configured suppliers and capability evidence

PATCH/api/v1/connections/{key}

Update connections

GET/api/v1/connections/{key}/dossier

Read or maintain supplier access evidence

PUT/api/v1/connections/{key}/dossier

Read or maintain supplier access evidence

POST/api/v1/connections/{key}/dossier/verify

Verify a supplier access dossier

Creatives

GET/api/v1/creatives

Read creatives

POST/api/v1/creatives

Run creatives

POST/api/v1/creatives/{id}/adapt

Run creatives / adapt

GET/api/v1/creatives/{id}/assets

Submit or list creative asset production jobs

POST/api/v1/creatives/{id}/assets

Submit or list creative asset production jobs

POST/api/v1/creatives/{id}/precheck

Precheck creative for the campaign

GET/api/v1/creatives/{id}/renditions/{index}.svg

Read creatives / renditions

POST/api/v1/creatives/{id}/revise

Run creatives / revise

POST/api/v1/creatives/{id}/submit

Submit creative for supplier review

POST/api/v1/creatives/generate

Generate creative concepts and copy

POST/api/v1/creatives/upload

Upload supplied creative bytes

Data

POST/api/v1/data/caci-acorn/classify

Classify postcodes using licensed CACI data

Files

GET/files/assets/{name}

Read files / assets

Go

GET/go/{vanitySlug}

Read go

Health

GET/api/v1/health

Check API process health

Identity

GET/api/v1/identity/cohorts

List or import consented identity cohorts

POST/api/v1/identity/cohorts

List or import consented identity cohorts

GET/api/v1/identity/cohorts/{cohortId}

Read identity / cohorts

POST/api/v1/identity/cohorts/{cohortId}/attempts/{attemptId}/resolve

Run identity / cohorts / attempts / resolve

POST/api/v1/identity/cohorts/{cohortId}/delete

Run identity / cohorts / delete

POST/api/v1/identity/cohorts/{cohortId}/map

Run identity / cohorts / map

POST/api/v1/identity/cohorts/{cohortId}/optout

Run identity / cohorts / optout

Internal

GET/api/v1/internal/fulfilment/bookings

Read assigned-client supplier work queue

GET/api/v1/internal/fulfilment/bookings/{bookingId}

Read internal / fulfilment / bookings

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/assign

Assign or transfer supplier work without retrying it

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/confirm

Run internal / fulfilment / bookings / lines / confirm

GET/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance

Review supplier report and invoice closeout

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance/artifacts

Store immutable supplier report or invoice evidence

GET/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance/artifacts/{artifactId}

Download original campaign-owned supplier evidence

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance/reconciliations

Independently compare separate supplier invoice with exact approved delivery

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance/reports

Submit normalized final supplier report for independent review

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/finance/reports/{reportId}/approve

Approve exact supplier report and settle actual delivery fees

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/reject

Run internal / fulfilment / bookings / lines / reject

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/start

Run internal / fulfilment / bookings / lines / start

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/stop-not-applied

Run internal / fulfilment / bookings / lines / stop not applied

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/stop-start

Run internal / fulfilment / bookings / lines / stop start

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/stopped

Run internal / fulfilment / bookings / lines / stopped

POST/api/v1/internal/fulfilment/bookings/{bookingId}/lines/{lineId}/uncertain

Run internal / fulfilment / bookings / lines / uncertain

GET/api/v1/internal/session

Read internal staff access

Inventory

GET/api/v1/inventory

Browse inventory for one channel

Measurement

POST/api/v1/measurement/mmm

Run measurement / mmm

GET/api/v1/measurement/mmm/readiness

Read measurement / mmm / readiness

Openapi.json

GET/api/v1/openapi.json

Download the product-scoped OpenAPI specification

Operator

GET/api/v1/operator/bookings

Read operator / bookings

GET/api/v1/operator/bookings/{bookingId}

Read operator / bookings

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/confirm

Run operator / bookings / lines / confirm

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/reject

Run operator / bookings / lines / reject

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/start

Run operator / bookings / lines / start

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/stop-not-applied

Run operator / bookings / lines / stop not applied

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/stop-start

Run operator / bookings / lines / stop start

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/stopped

Run operator / bookings / lines / stopped

POST/api/v1/operator/bookings/{bookingId}/lines/{lineId}/uncertain

Run operator / bookings / lines / uncertain

Optimizations

GET/api/v1/optimizations

Read optimizations

POST/api/v1/optimizations/{id}/approve

Run optimizations / approve

POST/api/v1/optimizations/{id}/reject

Run optimizations / reject

Personas

GET/api/v1/personas

Read personas

DELETE/api/v1/personas/{id}

Delete personas

GET/api/v1/personas/{id}

Read personas

PATCH/api/v1/personas/{id}

Update personas

POST/api/v1/personas/{id}/compile

Compile persona targeting for the product channels

POST/api/v1/personas/extract

Extract a persona from a natural-language brief

Planning

POST/api/v1/planning/provider-forecast

Request native provider forecast evidence

Plans

GET/api/v1/plans

Read plans

GET/api/v1/plans/{id}

Read plans

PATCH/api/v1/plans/{id}

Update plans

POST/api/v1/plans/{id}/approve

Approve a plan and create its campaign

GET/api/v1/plans/{id}/search-keywords

Read plans / search keywords

PATCH/api/v1/plans/{id}/search-keywords

Update plans / search keywords

POST/api/v1/plans/generate

Generate a forecasted media plan

POST/api/v1/plans/manual

Create a plan from selected inventory

Readyz

GET/readyz

Check deployment readiness

T

POST/api/v1/t/{pixelKey}

Record an anonymous pageview

GET/t/{pixelKey}