@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface BuildCreativeMultiSuccess

    Multi-format success response. Returned when the request used target_format_ids. Contains one manifest per requested format. Multi-format requests are atomic — all formats must succeed or the entire request fails with an error response. Array order corresponds to the target_format_ids request order.

    interface BuildCreativeMultiSuccess {
        creative_manifests: CreativeManifest[];
        sandbox?: boolean;
        expires_at?: string;
        preview?: {
            previews: {
                preview_id: string;
                format_id: FormatReferenceStructuredObject;
                renders: PreviewRender[];
                input: {
                    name: string;
                    macros?: { [k: string]: string | undefined };
                    context_description?: string;
                };
            }[];
            interactive_url?: string;
            expires_at: string;
        };
        preview_error?: Error;
        pricing_option_id?: string;
        vendor_cost?: number;
        currency?: string;
        consumption?: CreativeConsumption;
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    creative_manifests sandbox? expires_at? preview? preview_error? pricing_option_id? vendor_cost? currency? consumption? context? ext?

    Properties

    creative_manifests: CreativeManifest[]

    Array of generated creative manifests, one per requested format. Each manifest contains its own format_id identifying which format it was generated for.

    sandbox?: boolean

    When true, this response contains simulated data from sandbox mode.

    expires_at?: string

    ISO 8601 timestamp when the earliest generated asset URL expires across all manifests. Re-build after this time to get fresh URLs.

    date-time

    preview?: {
        previews: {
            preview_id: string;
            format_id: FormatReferenceStructuredObject;
            renders: PreviewRender[];
            input: {
                name: string;
                macros?: { [k: string]: string | undefined };
                context_description?: string;
            };
        }[];
        interactive_url?: string;
        expires_at: string;
    }

    Preview renders included when the request set include_preview to true and the agent supports it. Contains one default preview per requested format. preview_inputs is ignored for multi-format requests.

    Type Declaration

    • previews: {
          preview_id: string;
          format_id: FormatReferenceStructuredObject;
          renders: PreviewRender[];
          input: {
              name: string;
              macros?: { [k: string]: string | undefined };
              context_description?: string;
          };
      }[]

      Array of preview entries, one per requested format. Array order matches creative_manifests. Each entry includes a format_id for explicit correlation.

    • Optionalinteractive_url?: string

      Optional URL to an interactive testing page that shows all format previews with controls to switch between them.

    • expires_at: string

      ISO 8601 timestamp when preview URLs expire. May differ from the manifest's expires_at.

      date-time

    preview_error?: Error
    pricing_option_id?: string

    Which rate card pricing option was applied for this build. Represents the total cost of the entire multi-format build call. Present when the creative agent charges for its services.

    vendor_cost?: number

    Total cost incurred for this multi-format build, denominated in currency. May be 0 for CPM-priced creatives where cost accrues at serve time.

    0

    currency?: string

    ISO 4217 currency code for vendor_cost.

    ^[A-Z]{3}$

    consumption?: CreativeConsumption
    context?: ContextObject
    ext?: ExtensionObject

    Settings

    Member Visibility

    On This Page

    Properties