Confirm a change your AI client asked for, as a buyer: it's made at once with your own token, and its outcome kept. A path's or a campaign's change takes expected_sequence, its sequence as the page showed it

POST

/v1/buyer/ai-confirmations/{id}/confirm

curl --request POST \
  --url https://example.com/v1/buyer/ai-confirmations/example/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "expected_sequence": 1 }'

Who: a workspace’s buyer. Not for API keys.

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

Request Body^required

Media typeapplication/json

object

expected_sequence

integer format: int64

Example ^generated

{
  "expected_sequence": 1
}

Responses

200

OK

Media typeapplication/json

object

arguments

required

client

required

object

host

required

string

id

required

string

name

required

string

redirect_host

required

string

completed_at

required

string | null format: date-time

context

created_at

required

string format: date-time

decided_at

required

string | null format: date-time

decided_by

required

Any of:

object

object

account

string

id

string

kind

required

string | null

Allowed values: user api_key service system postback rule tuner schedule

name

string

null

null

error_message

string

error_reason

string

expires_at

required

string format: date-time

grant_id

required

string

id

required

string

outcome

required

review

Any of:

object

object

items

required

Array<object>

object

action

required

string

campaign_url

string

changes

required

Array<object>

object

field

required

string

from

required

from_host

string

new_host

boolean

to

required

to_host

string

connection

string

expected_sequence

integer format: int64

id

integer format: int64

name

required

string

network

string

object

required

string

sequence

integer format: int64

stale

required

boolean

updated_at

string

null

null

stale_items

Array<string>

status

required

string | null

Allowed values: pending confirmed declined expired done failed

targets

object

key

additional properties

tool

required

string

url

required

string

user_id

required

string

Example

{
  "decided_by": {
    "kind": "user"
  },
  "status": "pending"
}

default

An error, as go-commons apperr maps it

Media typeapplication/json

object

error

required

object

code

required

string

fields

object

key

additional properties

string

message

required

string

Example ^generated

{
  "error": {
    "code": "example",
    "fields": {
      "additionalProperty": "example"
    },
    "message": "example"
  }
}