Plan controlled action adapter handoff

Builds an adapter invocation plan for an approved controlled action. Persist=false keeps planning separate from execution.

post/official-adapter-invocation-plan

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/official-adapter-invocation-plan
  • Auth: HTTP bearer

Request body

action_idstring required
operator_idstring
adapter'auto' | 'google_ads_api' | 'meta_official_mcp' | 'microsoft_ads_rest_api' | 'noop'

Optional adapter hint. When omitted or auto, the server derives the adapter from the persisted controlled-action platform.

execute_mode'dry_run' | 'live'

Hosted live execution must hand off to the action worker; request-time adapter dispatch is not allowed in hosted SaaS.

adapter_contextobject
persistboolean

Response

Invocation plan

schema_versionstring
statusstring
summaryobject

Changes

No recorded changes to this operation across all 1 revision of this API.