Record controlled action execution attempt

Records the execution attempt. In hosted SaaS, live execution must be queued for the action worker; the request thread does not write ad platforms.

post/controlled-action/execute

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/controlled-action/execute
  • Auth: HTTP bearer

Request body

action_idstring required
request_idstring required
requested_bystring
confirmationstring
platformstring
ad_account_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
execution_notestring
audit_contextobject

Response

Execution result or worker queue handoff

statusstring required
action_idstring
request_idstring
resultobject
official_adapter_invocation_planobject
freshness_gateobject

Changes

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