Interface ReportPlanOutcomeRequest

Report the outcome of an action to the governance agent. Called by the orchestrator (buyer-side agent) after a seller responds. This is the 'after' half of the governance loop. Sellers do not call this task -- they report delivery data via check_governance with phase 'delivery'.

interface ReportPlanOutcomeRequest {
    adcp_major_version?: number;
    plan_id: string;
    check_id?: string;
    idempotency_key: string;
    purchase_type?: PurchaseType;
    outcome: OutcomeType;
    seller_response?: {
        seller_reference?: string;
        committed_budget?: number;
        packages?: { budget?: number }[];
        planned_delivery?: PlannedDelivery;
        creative_deadline?: string;
    };
    delivery?: {
        reporting_period?: { start: string; end: string };
        impressions?: number;
        spend?: number;
        cpm?: number;
        viewability_rate?: number;
        completion_rate?: number;
    };
    error?: { code?: string; message?: string };
    governance_context: string;
    context?: ContextObject;
    ext?: ExtensionObject;
}

Index

Properties

adcp_major_version? plan_id check_id? idempotency_key purchase_type? outcome seller_response? delivery? error? governance_context context? ext?

Properties

`Optional`adcp_major_version

adcp_major_version?: number

The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.

Minimum

Maximum

plan_id

plan_id: string

The plan this outcome is for. The plan uniquely scopes the account and operator; do not include a separate account field — the governance agent resolves account from the plan. Including account is rejected by additionalProperties: false.

`Optional`check_id

check_id?: string

The check_id from check_governance. Links the outcome to the governance check that authorized it. Required for 'completed' and 'failed' outcomes.

idempotency_key

idempotency_key: string

Client-generated unique key for this request. Prevents duplicate outcome reports on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.

Min Length

Max Length

255

Pattern

^[A-Za-z0-9_.:-]{16,255}$

`Optional`purchase_type

purchase_type?: PurchaseType

outcome

outcome: OutcomeType

`Optional`seller_response

seller_response?: {
    seller_reference?: string;
    committed_budget?: number;
    packages?: { budget?: number }[];
    planned_delivery?: PlannedDelivery;
    creative_deadline?: string;
}

The seller's full response. Required when outcome is 'completed'.

Type Declaration

Optionalseller_reference?: string
The seller's identifier for the created resource (e.g., media_buy_id, rights_grant_id, deployment_id). Not interpreted by the governance agent — included in audit logs for human-readable traceability alongside the opaque governance_context.

Max Length
255
Optionalcommitted_budget?: number
Total budget committed across all confirmed packages. When present, the governance agent uses this directly instead of summing package budgets.

Minimum
0
Optionalpackages?: { budget?: number }[]
Confirmed packages with actual budget and targeting.
Optionalplanned_delivery?: PlannedDelivery
Optionalcreative_deadline?: string
ISO 8601 deadline for creative submission.

Format
date-time

`Optional`delivery

delivery?: {
    reporting_period?: { start: string; end: string };
    impressions?: number;
    spend?: number;
    cpm?: number;
    viewability_rate?: number;
    completion_rate?: number;
}

Delivery metrics. Required when outcome is 'delivery'.

Type Declaration

Optionalreporting_period?: { start: string; end: string }
Start and end timestamps for the reporting window.
- start: string
  Format
  date-time
- end: string
  Format
  date-time
Optionalimpressions?: number
Impressions delivered in the period.

Minimum
0
Optionalspend?: number
Spend in the period.
Optionalcpm?: number
Effective CPM for the period.
Optionalviewability_rate?: number
Viewability rate (0-1).
Optionalcompletion_rate?: number
Video completion rate (0-1).

`Optional`error

error?: { code?: string; message?: string }

Error details. Required when outcome is 'failed'.

Type Declaration

Optionalcode?: string
Error code from the seller.
Optionalmessage?: string
Human-readable error description.

governance_context

governance_context: string

Opaque governance context from the check_governance response that authorized this action. Enables the governance agent to correlate the outcome to the original check.

Min Length

Max Length

4096

Pattern

^[\x20-\x7E]+$

`Optional`context

context?: ContextObject

`Optional`ext

ext?: ExtensionObject

Interface ReportPlanOutcomeRequest

Index

Properties

Properties

Optionaladcp_major_version

Minimum

Maximum

plan_id

Optionalcheck_id

idempotency_key

Min Length

Max Length

Pattern

Optionalpurchase_type

outcome

Optionalseller_response

Type Declaration

Optionalseller_reference?: string

Max Length

Optionalcommitted_budget?: number

Minimum

Optionalpackages?: { budget?: number }[]

Optionalplanned_delivery?: PlannedDelivery

Optionalcreative_deadline?: string

Format

Optionaldelivery

Type Declaration

Optionalreporting_period?: { start: string; end: string }

start: string

Format

end: string

Format

Optionalimpressions?: number

Minimum

Optionalspend?: number

Optionalcpm?: number

Optionalviewability_rate?: number

Optionalcompletion_rate?: number

Optionalerror

Type Declaration

Optionalcode?: string

Optionalmessage?: string

governance_context

Min Length

Max Length

Pattern

Optionalcontext

Optionalext

Settings

On This Page

`Optional`adcp_major_version

`Optional`check_id

`Optional`purchase_type

`Optional`seller_response

`Optional`seller_reference?: string

`Optional`committed_budget?: number

`Optional`packages?: { budget?: number }[]

`Optional`planned_delivery?: PlannedDelivery

`Optional`creative_deadline?: string

`Optional`delivery

`Optional`reporting_period?: { start: string; end: string }

`Optional`impressions?: number

`Optional`spend?: number

`Optional`cpm?: number

`Optional`viewability_rate?: number

`Optional`completion_rate?: number

`Optional`error

`Optional`code?: string

`Optional`message?: string

`Optional`context

`Optional`ext