@mocart-io/api 1.0.1

package/dist/generated/types.gen.d.ts

@@ -0,0 +1,1367 @@
+export type ClientOptions = {
+    baseUrl: `${string}://${string}/api/public/v1` | (string & {});
+};
+export type Webhooks = RunCompletedWebhookWebhookRequest;
+export type Product = {
+    /**
+     * Resource discriminator — always `"product"`.
+     */
+    object: 'product';
+    /**
+     * Stable product identifier (the internal document id).
+     */
+    productId: string;
+    /**
+     * Merchant SKU (`core.mpn`); `null` when the product has none.
+     */
+    sku: string | null;
+    /**
+     * Product title; `null` when absent.
+     */
+    title: string | null;
+    /**
+     * Owning brand id; `null` when the product is not brand-scoped.
+     */
+    brandId: string | null;
+    /**
+     * Canonical merchant product URL; `null` when absent.
+     */
+    productUrl: string | null;
+    /**
+     * Best display thumbnail URL; `null` when the product has no image.
+     */
+    image: string | null;
+    /**
+     * Product creation time as an ISO-8601 string; `null` only for a legacy doc lacking one.
+     */
+    createdAt: string | null;
+};
+export type Pagination = {
+    /**
+     * Opaque keyset cursor; `null` ONLY on the last page. Pass back verbatim as `?cursor=`.
+     */
+    nextCursor: string | null;
+    /**
+     * Convenience mirror of `nextCursor !== null`. NEVER stop iterating on empty `data`.
+     */
+    hasMore: boolean;
+    /**
+     * The page size applied to this response.
+     */
+    pageSize: number;
+};
+export type ProductList = {
+    /**
+     * Resource discriminator — always `"list"`.
+     */
+    object: 'list';
+    data: Array<Product>;
+    pagination: Pagination;
+};
+export type AccountSpendBudget = {
+    /**
+     * The account's daily API credit cap.
+     */
+    capCredits: number;
+    /**
+     * Credits already committed today (UTC).
+     */
+    spentCredits: number;
+    /**
+     * What is left of the cap today; never negative.
+     */
+    remainingCredits: number;
+    /**
+     * RFC 3339 UTC instant the budget resets at (the next midnight UTC). ABSOLUTE — render it locally.
+     */
+    resetsAt: string;
+};
+export type ProblemDetails = {
+    /**
+     * Stable URI reference identifying the problem type, e.g. `/errors/PRODUCT_NOT_FOUND`.
+     */
+    type: string;
+    /**
+     * Stable human-readable summary of the problem type (the HTTP status phrase).
+     */
+    title: string;
+    /**
+     * HTTP status code, duplicated in the body per RFC 9457.
+     */
+    status: number;
+    /**
+     * Stable machine-readable error code, e.g. `PRODUCT_NOT_FOUND`.
+     */
+    code: string;
+    /**
+     * Human-readable, non-leaky explanation of this occurrence.
+     */
+    detail?: string;
+    /**
+     * URI reference for this occurrence (the request path).
+     */
+    instance?: string;
+    /**
+     * Per-request correlation id for support triage.
+     */
+    requestId: string;
+    /**
+     * Per-field validation failures (present on a 422).
+     */
+    errors?: Array<{
+        /**
+         * Dotted path of the offending field (absent for a whole-body error).
+         */
+        field?: string;
+        /**
+         * Human-readable reason the field failed.
+         */
+        message: string;
+    }>;
+    budget?: AccountSpendBudget;
+};
+export type Creative = {
+    /**
+     * Resource discriminator — always `"creative"`.
+     */
+    object: 'creative';
+    /**
+     * Stable creative identifier (the internal document id).
+     */
+    creativeId: string;
+    /**
+     * Id of the product this creative belongs to.
+     */
+    productId: string;
+    /**
+     * Id of the campaign this creative was generated under.
+     */
+    campaignId: string;
+    /**
+     * Owning brand id, denormalized from the linked product at creation; `null` when the product is not brand-scoped or the creative predates the denormalization backfill.
+     */
+    brandId: string | null;
+    /**
+     * Merchant SKU (the linked product's `core.mpn`), denormalized onto the creative; `null` when the product carries no SKU or the creative predates the denormalization backfill.
+     */
+    sku: string | null;
+    /**
+     * Creative media type: `image` (STATIC) or `video` (VIDEO). 3D/PLAYABLE are never exposed.
+     */
+    mediaType: 'image' | 'video';
+    /**
+     * Durable URL of the creative asset.
+     */
+    url: string;
+    /**
+     * Poster/thumbnail URL; `null` when the creative has none.
+     */
+    thumbnailUrl: string | null;
+    /**
+     * Creative aspect ratio (e.g. `1:1`, `9:16`); `null` when it cannot be resolved.
+     */
+    aspectRatio: string | null;
+    /**
+     * Review/approval time as an ISO-8601 string; `null` when the creative was not reviewed.
+     */
+    approvedAt: string | null;
+    /**
+     * Hosted player URL when the creative links a published video; `null` otherwise.
+     */
+    playerUrl: string | null;
+    /**
+     * Iframe embed snippet when the creative links a published video; `null` otherwise.
+     */
+    embedCode: string | null;
+    /**
+     * The linked product, present ONLY when the read requested `?expand=product`: the full `ProductResponse`, or `null` when the linked product is missing/hard-deleted. ABSENT when expansion is not requested.
+     */
+    product?: Product | null;
+};
+export type CreativeList = {
+    /**
+     * Resource discriminator — always `"list"`.
+     */
+    object: 'list';
+    data: Array<Creative>;
+    pagination: Pagination;
+};
+export type Asset = {
+    /**
+     * Resource discriminator — always `"asset"`.
+     */
+    object: 'asset';
+    /**
+     * Stable asset identifier (the internal document id).
+     */
+    assetId: string;
+    /**
+     * Id of the product this asset belongs to.
+     */
+    productId: string;
+    /**
+     * Asset media type: `VIDEO`, `STATIC` (image), or `3D` (model).
+     */
+    type: 'VIDEO' | 'STATIC' | '3D';
+    /**
+     * Durable public URL of the asset (the type-matched video / image / model URL).
+     */
+    url: string;
+    /**
+     * Poster/thumbnail URL; `null` when the asset has none.
+     */
+    thumbnailUrl: string | null;
+    /**
+     * User shortlist (favorite) flag; `false` when the asset was never shortlisted.
+     */
+    favorited: boolean;
+    /**
+     * Stored asset lifecycle status (e.g. `active`, `completed`).
+     */
+    status: string;
+    /**
+     * Human-readable asset name (falls back to the 3D `title`); `null` when the asset has neither.
+     */
+    name: string | null;
+    /**
+     * Intrinsic media width in pixels; `null` when unknown.
+     */
+    width: number | null;
+    /**
+     * Intrinsic media height in pixels; `null` when unknown.
+     */
+    height: number | null;
+    /**
+     * Video duration in seconds; `null` for non-video or when unknown.
+     */
+    durationSec: number | null;
+    /**
+     * Hosted player URL when the asset links a published video; `null` otherwise.
+     */
+    playerUrl: string | null;
+    /**
+     * Iframe embed snippet when the asset links a published video; `null` otherwise.
+     */
+    embedCode: string | null;
+    /**
+     * Asset creation time as an ISO-8601 string; `null` only for a legacy doc lacking a coercible one.
+     */
+    createdAt: string | null;
+};
+export type AssetList = {
+    /**
+     * Resource discriminator — always `"list"`.
+     */
+    object: 'list';
+    data: Array<Asset>;
+    pagination: Pagination;
+};
+export type Campaign = {
+    /**
+     * Resource discriminator — always `"campaign"`.
+     */
+    object: 'campaign';
+    /**
+     * Stable campaign identifier (the internal document id).
+     */
+    campaignId: string;
+    /**
+     * Human-readable campaign name.
+     */
+    name: string;
+    /**
+     * The campaign's generation-progress status; allowed values are enumerated by this schema's enum.
+     */
+    status: 'IN_PROGRESS' | 'READY' | 'BLOCKED' | 'COMPLETED';
+    /**
+     * Id of the brand this campaign belongs to.
+     */
+    brandId: string;
+    /**
+     * APPROXIMATE, denormalized best-effort count of the campaign's creatives. It is a fire-and-forget lazy recompute that can drift slightly from the live creative set — treat it as indicative, not exact.
+     */
+    creativeCount: number;
+    /**
+     * Campaign creation time as an ISO-8601 string; `null` only for a legacy doc lacking a coercible one.
+     */
+    createdAt: string | null;
+};
+export type CampaignList = {
+    /**
+     * Resource discriminator — always `"list"`.
+     */
+    object: 'list';
+    data: Array<Campaign>;
+    pagination: Pagination;
+};
+export type DeliveryItem = {
+    /**
+     * Resource discriminator — always `"delivery_item"`.
+     */
+    object: 'delivery_item';
+    /**
+     * Id of the asset that was delivered by this item.
+     */
+    assetId: string;
+    /**
+     * Id of the product this delivered asset belongs to.
+     */
+    productId: string;
+    /**
+     * The item's per-asset delivery status; allowed values are enumerated by this schema's enum.
+     */
+    status: 'QUEUED' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED';
+    /**
+     * Public URL of the LIVE delivered post/media (e.g. the instagram.com/p/… permalink); `null` until it succeeds.
+     */
+    permalinkUrl: string | null;
+    /**
+     * Provider-side published id (post / media / ad id); `null` until the item succeeds.
+     */
+    externalId: string | null;
+    /**
+     * Item success time as an ISO-8601 string; `null` when the item has not succeeded.
+     */
+    succeededAt: string | null;
+};
+export type Delivery = {
+    /**
+     * Resource discriminator — always `"delivery"`.
+     */
+    object: 'delivery';
+    /**
+     * Stable delivery-run identifier (the internal run document id).
+     */
+    deliveryId: string;
+    /**
+     * The run's target delivery platform; allowed values are enumerated by this schema's enum.
+     */
+    platform: 'instagram' | 'facebook' | 'x' | 'tiktok' | 'shopify' | 'woocommerce' | 'bigcommerce' | 'magento' | 'wix' | 'meta-ads' | 'tiktok-ads' | 'google-display' | 'taboola';
+    /**
+     * The run's aggregate delivery status; allowed values are enumerated by this schema's enum.
+     */
+    status: 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ISSUES' | 'FAILED';
+    /**
+     * Aggregate per-status item counters for the run.
+     */
+    itemCounts: {
+        /**
+         * Total items in the run.
+         */
+        total: number;
+        /**
+         * Items still queued (not yet started).
+         */
+        queued: number;
+        /**
+         * Items currently in flight.
+         */
+        processing: number;
+        /**
+         * Items that succeeded.
+         */
+        succeeded: number;
+        /**
+         * Items that failed.
+         */
+        failed: number;
+    };
+    /**
+     * Run start time as an ISO-8601 string; `null` only for a legacy doc lacking a coercible one.
+     */
+    startedAt: string | null;
+    /**
+     * Run completion time as an ISO-8601 string; `null` while the run is still in flight.
+     */
+    completedAt: string | null;
+    /**
+     * The run-level failure `{ type, message }`; `null` when the run has no recorded error.
+     */
+    error: {
+        /**
+         * Canonical failure code (the run `errorType`).
+         */
+        type: string;
+        /**
+         * User-safe one-liner; `null` when none was recorded.
+         */
+        message: string | null;
+    } | null;
+    /**
+     * The run's per-asset delivery items, present ONLY when the read requested `?expand=items`. ABSENT when expansion is not requested.
+     */
+    items?: Array<DeliveryItem>;
+};
+export type DeliveryList = {
+    /**
+     * Resource discriminator — always `"list"`.
+     */
+    object: 'list';
+    data: Array<Delivery>;
+    pagination: Pagination;
+};
+export type CreateRunRequest = {
+    brandId: string;
+    presetId?: string;
+    accountPresetId?: string;
+    productIds: Array<string>;
+    modality: 'image' | 'video';
+    creativesPerProduct?: number;
+    selections?: {
+        [key: string]: string;
+    };
+    occasionId?: string;
+    brandToneId?: string;
+    aspectRatio: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
+    video?: {
+        /**
+         * Length in seconds.
+         */
+        duration: 4 | 6 | 8;
+        /**
+         * Output resolution.
+         */
+        resolution?: '720p';
+        /**
+         * What the video starts from: `product` animates the product photo; `styled` first generates a frame from the style and direction, at no extra charge.
+         */
+        firstFrame?: 'product' | 'styled';
+    };
+    /**
+     * Your direction for the creative. With a preset it steers the preset; without one it is the whole brief. At most 8000 characters for images and 4000 for video.
+     */
+    prompt?: string;
+    includeProductName?: boolean;
+    applyBrandKit?: boolean;
+    metadata?: {
+        [key: string]: string;
+    };
+    maxCredits?: number;
+    expectedTotalCredits?: number;
+    dryRun?: boolean;
+};
+export type RunCompletionEstimate = {
+    /**
+     * `createdAt + durationSeconds`, as an ISO 8601 UTC instant.
+     */
+    completesAt: string;
+    /**
+     * Whole seconds of expected wall-clock for the whole run.
+     */
+    durationSeconds: number;
+    /**
+     * How many of this run's items are expected to be in flight at once.
+     */
+    concurrency: number;
+    /**
+     * The measured per-item wall-clock the duration was derived from.
+     */
+    perItemSeconds: number;
+};
+export type RunQuote = {
+    /**
+     * What one creative costs under this rate card.
+     */
+    perItemCredits: number;
+    /**
+     * `perItemCredits` × the number of creatives in the run.
+     */
+    totalCredits: number;
+    /**
+     * The price list this quote was computed from; pinned at create.
+     */
+    rateCardVersion: string;
+};
+export type RunEstimate = {
+    object: 'run_estimate';
+    estimate: RunQuote;
+    budget?: AccountSpendBudget;
+};
+export type RunCredits = {
+    /**
+     * The quoted total the caller agreed to — a ceiling, not a charge.
+     */
+    estimated: number | null;
+    rateCardVersion: string | null;
+};
+export type RunCounts = {
+    succeeded: number;
+    failed: number;
+    refused: number;
+    stopped: number;
+    /**
+     * Items with no terminal answer yet; on a final run, those that never reported.
+     */
+    pending: number;
+};
+export type Run = {
+    runId: string;
+    object: 'run';
+    /**
+     * The run lifecycle status.
+     */
+    status: 'QUEUED' | 'RUNNING' | 'STOPPING' | 'SUCCEEDED' | 'PARTIAL' | 'FAILED' | 'REFUSED' | 'STOPPED' | 'EXPIRED';
+    /**
+     * Planned creatives: products × creativesPerProduct.
+     */
+    total: number;
+    credits: RunCredits;
+    createdAt: string;
+    /**
+     * `null` until the run is final.
+     */
+    finalizedAt: string | null;
+    counts?: RunCounts;
+    /**
+     * Omitted when an input to the arithmetic is unavailable; poll conservatively then.
+     */
+    estimatedCompletion?: RunCompletionEstimate;
+};
+export type RunList = {
+    object: 'list';
+    data: Array<Run>;
+    pagination: Pagination;
+};
+export type RunItem = {
+    object: 'run_item';
+    productId: string;
+    /**
+     * Position in the run, in request order.
+     */
+    itemIndex: number;
+    jobId: string;
+    outcome: 'succeeded' | 'failed' | 'refused' | 'stopped' | 'pending';
+    /**
+     * Set on a `failed` or `refused` item; `null` otherwise.
+     */
+    errorCode: 'INSUFFICIENT_CREDITS' | 'SPEND_CEILING_REACHED' | 'SAFETY_REFUSED' | 'SAFETY_UNAVAILABLE' | 'PROVIDER_FAILED' | 'STOPPED' | 'NO_PRIMARY_IMAGE' | 'TRY_AGAIN' | null;
+    /**
+     * Which ceiling stopped the item: raise `maxCredits` for `run`; `account` is not per-request.
+     */
+    ceiling?: 'run' | 'account';
+    /**
+     * Set only when `outcome` is `succeeded`.
+     */
+    assetId: string | null;
+    /**
+     * The creative's public URL, set only when `outcome` is `succeeded`. Permanent today; keep `assetId` with it, since how assets are served may change.
+     */
+    assetUrl: string | null;
+};
+export type RunItemList = {
+    object: 'list';
+    data: Array<RunItem>;
+    pagination: Pagination;
+};
+export type RunPreset = {
+    /**
+     * Pass as `presetId` on `POST /runs` or `POST /runs/estimate`.
+     */
+    presetId: string;
+    object: 'preset';
+    /**
+     * The `selections` keys this preset understands.
+     */
+    readonly controlIds: Array<string>;
+};
+export type RunPresetList = {
+    object: 'list';
+    data: Array<RunPreset>;
+    pagination: Pagination;
+};
+export type RunCompletedEvent = {
+    /**
+     * Fires when a run reaches a terminal status.
+     */
+    type: 'run.completed';
+    timestamp: string;
+    data: Run;
+};
+export type RunPresetWritable = {
+    /**
+     * Pass as `presetId` on `POST /runs` or `POST /runs/estimate`.
+     */
+    presetId: string;
+    object: 'preset';
+};
+export type RunPresetListWritable = {
+    object: 'list';
+    data: Array<RunPresetWritable>;
+    pagination: Pagination;
+};
+export type ListProductsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Opaque base64url keyset cursor from a prior page's `pagination.nextCursor`. Omit for the first page; pass it back verbatim to continue.
+         */
+        cursor?: string;
+        /**
+         * Optional filter by owning brand id. MUTUALLY EXCLUSIVE with `sku` — supplying both is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        brandId?: string;
+        /**
+         * Optional filter by merchant SKU (raw `core.mpn`, case-sensitive). MUTUALLY EXCLUSIVE with `brandId` — supplying both is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        sku?: string;
+    };
+    url: '/products';
+};
+export type ListProductsErrors = {
+    /**
+     * Bad Request. The `cursor` query parameter is not a valid opaque keyset cursor (`INVALID_CURSOR`), OR `brandId` and `sku` were supplied together (`INVALID_FILTER_COMBINATION`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content. A query parameter failed field validation (e.g. a non-string shape); the offending fields are enumerated in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type ListProductsError = ListProductsErrors[keyof ListProductsErrors];
+export type ListProductsResponses = {
+    /**
+     * OK. One keyset-paginated page of products.
+     */
+    200: ProductList;
+};
+export type ListProductsResponse = ListProductsResponses[keyof ListProductsResponses];
+export type GetProductByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Stable Mocart product document id.
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/products/{id}';
+};
+export type GetProductByIdErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found. No product matched the identifier (`PRODUCT_NOT_FOUND`). A cross-tenant id returns this SAME uniform 404 (no-leak).
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type GetProductByIdError = GetProductByIdErrors[keyof GetProductByIdErrors];
+export type GetProductByIdResponses = {
+    /**
+     * OK. The single product.
+     */
+    200: Product;
+};
+export type GetProductByIdResponse = GetProductByIdResponses[keyof GetProductByIdResponses];
+export type ListCreativesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Opaque base64url keyset cursor from a prior page's `pagination.nextCursor`. Omit for the first page; pass it back verbatim to continue.
+         */
+        cursor?: string;
+        /**
+         * Filter by creative status. Defaults to `APPROVED` when omitted.
+         */
+        status?: 'NOT_GENERATED' | 'QUEUED' | 'GENERATING' | 'PENDING' | 'APPROVED' | 'REJECTED' | 'FAILED';
+        /**
+         * Optional filter by owning campaign id. MUTUALLY EXCLUSIVE with the other filters (campaignId/productId/brandId/sku) — supplying more than one is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        campaignId?: string;
+        /**
+         * Optional filter by linked product id. MUTUALLY EXCLUSIVE with the other filters (campaignId/productId/brandId/sku) — supplying more than one is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        productId?: string;
+        /**
+         * Optional filter by owning brand id (denormalized from the linked product). MUTUALLY EXCLUSIVE with the other filters (campaignId/productId/brandId/sku) — supplying more than one is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        brandId?: string;
+        /**
+         * Optional filter by merchant SKU (the linked product's `core.mpn`, denormalized onto the creative). MUTUALLY EXCLUSIVE with the other filters (campaignId/productId/brandId/sku) — supplying more than one is a 400 (`INVALID_FILTER_COMBINATION`).
+         */
+        sku?: string;
+        /**
+         * Optional relation expansion. `product` joins each creative's linked `Product` into a `product` field (the full `ProductResponse`, or `null` when the linked product is missing/hard-deleted). Absent by default; an unknown expand token is IGNORED (not a 422).
+         */
+        expand?: 'product';
+    };
+    url: '/creatives';
+};
+export type ListCreativesErrors = {
+    /**
+     * Bad Request. The `cursor` query parameter is not a valid opaque keyset cursor (`INVALID_CURSOR`), OR more than one of the mutually-exclusive scope filters `campaignId` / `productId` / `brandId` / `sku` was supplied together (`INVALID_FILTER_COMBINATION`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content. A query parameter failed field validation (e.g. a non-string shape); the offending fields are enumerated in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type ListCreativesError = ListCreativesErrors[keyof ListCreativesErrors];
+export type ListCreativesResponses = {
+    /**
+     * OK. One keyset-paginated page of creatives.
+     */
+    200: CreativeList;
+};
+export type ListCreativesResponse = ListCreativesResponses[keyof ListCreativesResponses];
+export type GetCreativeByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Stable Mocart creative document id.
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Optional relation expansion. `product` joins the creative's linked `Product` into a `product` field (the full `ProductResponse`, or `null` when the linked product is missing/hard-deleted). Absent by default; an unknown expand token is IGNORED (not a 422).
+         */
+        expand?: 'product';
+    };
+    url: '/creatives/{id}';
+};
+export type GetCreativeByIdErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found. No creative matched the identifier (`CREATIVE_NOT_FOUND`). A cross-tenant, soft-deleted, or non-usable (3D/PLAYABLE) creative id returns this SAME uniform 404 (no-leak).
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type GetCreativeByIdError = GetCreativeByIdErrors[keyof GetCreativeByIdErrors];
+export type GetCreativeByIdResponses = {
+    /**
+     * OK. The single creative.
+     */
+    200: Creative;
+};
+export type GetCreativeByIdResponse = GetCreativeByIdResponses[keyof GetCreativeByIdResponses];
+export type ListAssetsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Opaque base64url keyset cursor from a prior page's `pagination.nextCursor`. Omit for the first page; pass it back verbatim to continue.
+         */
+        cursor?: string;
+        /**
+         * Optional filter by asset media type. Combinable with `status`.
+         */
+        type?: 'VIDEO' | 'STATIC' | '3D';
+        /**
+         * Optional filter by stored asset status. When omitted, defaults to the ready set (`active` + `completed`). Combinable with `type`.
+         */
+        status?: 'active' | 'completed' | 'pending' | 'processing' | 'failed' | 'approved' | 'archived' | 'deprecated' | 'beta';
+        /**
+         * Optional TRUE-ONLY shortlist filter: pass `true` to return only shortlisted (favorited) assets; omit for all. Any non-`true` value is ignored (no filter). Combinable with `type` and `status`.
+         */
+        favorited?: boolean;
+    };
+    url: '/assets';
+};
+export type ListAssetsErrors = {
+    /**
+     * Bad Request. The `cursor` query parameter is not a valid opaque keyset cursor (`INVALID_CURSOR`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content. A query parameter failed field validation (e.g. a non-string shape); the offending fields are enumerated in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type ListAssetsError = ListAssetsErrors[keyof ListAssetsErrors];
+export type ListAssetsResponses = {
+    /**
+     * OK. One keyset-paginated page of assets.
+     */
+    200: AssetList;
+};
+export type ListAssetsResponse = ListAssetsResponses[keyof ListAssetsResponses];
+export type GetAssetByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Stable Mocart asset document id.
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/assets/{id}';
+};
+export type GetAssetByIdErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found. No asset matched the identifier (`ASSET_NOT_FOUND`). A cross-tenant, soft-deleted, or non-usable (no stored url) asset id returns this SAME uniform 404 (no-leak).
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type GetAssetByIdError = GetAssetByIdErrors[keyof GetAssetByIdErrors];
+export type GetAssetByIdResponses = {
+    /**
+     * OK. The single asset.
+     */
+    200: Asset;
+};
+export type GetAssetByIdResponse = GetAssetByIdResponses[keyof GetAssetByIdResponses];
+export type ListCampaignsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Opaque base64url keyset cursor from a prior page's `pagination.nextCursor`. Omit for the first page; pass it back verbatim to continue.
+         */
+        cursor?: string;
+        /**
+         * Optional filter by campaign lifecycle status. When omitted, ALL non-deleted campaigns are returned (there is NO default status).
+         */
+        status?: 'IN_PROGRESS' | 'READY' | 'BLOCKED' | 'COMPLETED';
+    };
+    url: '/campaigns';
+};
+export type ListCampaignsErrors = {
+    /**
+     * Bad Request. The `cursor` query parameter is not a valid opaque keyset cursor (`INVALID_CURSOR`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content. A query parameter failed field validation (e.g. a non-string shape); the offending fields are enumerated in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type ListCampaignsError = ListCampaignsErrors[keyof ListCampaignsErrors];
+export type ListCampaignsResponses = {
+    /**
+     * OK. One keyset-paginated page of campaigns.
+     */
+    200: CampaignList;
+};
+export type ListCampaignsResponse = ListCampaignsResponses[keyof ListCampaignsResponses];
+export type GetCampaignByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Stable Mocart campaign document id.
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/campaigns/{id}';
+};
+export type GetCampaignByIdErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found. No campaign matched the identifier (`CAMPAIGN_NOT_FOUND`). A cross-tenant or soft-deleted campaign id returns this SAME uniform 404 (no-leak).
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type GetCampaignByIdError = GetCampaignByIdErrors[keyof GetCampaignByIdErrors];
+export type GetCampaignByIdResponses = {
+    /**
+     * OK. The single campaign.
+     */
+    200: Campaign;
+};
+export type GetCampaignByIdResponse = GetCampaignByIdResponses[keyof GetCampaignByIdResponses];
+export type ListDeliveriesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Opaque base64url keyset cursor from a prior page's `pagination.nextCursor`. Omit for the first page; pass it back verbatim to continue.
+         */
+        cursor?: string;
+        /**
+         * Optional filter by delivery-run status. When omitted, ALL non-deleted runs are returned (there is NO default status). Combinable with `platform`.
+         */
+        status?: 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ISSUES' | 'FAILED';
+        /**
+         * Optional filter by target delivery platform. When omitted, runs for ALL platforms are returned. Combinable with `status`.
+         */
+        platform?: 'instagram' | 'facebook' | 'x' | 'tiktok' | 'shopify' | 'woocommerce' | 'bigcommerce' | 'magento' | 'wix' | 'meta-ads' | 'tiktok-ads' | 'google-display' | 'taboola';
+        /**
+         * Optional relation expansion. `items` joins each delivery's per-asset items into an `items` array (each a `DeliveryItem` with its live `permalinkUrl`). Absent by default; an unknown expand token is IGNORED (not a 422).
+         */
+        expand?: 'items';
+    };
+    url: '/deliveries';
+};
+export type ListDeliveriesErrors = {
+    /**
+     * Bad Request. The `cursor` query parameter is not a valid opaque keyset cursor (`INVALID_CURSOR`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content. A query parameter failed field validation (e.g. a non-string shape); the offending fields are enumerated in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type ListDeliveriesError = ListDeliveriesErrors[keyof ListDeliveriesErrors];
+export type ListDeliveriesResponses = {
+    /**
+     * OK. One keyset-paginated page of deliveries.
+     */
+    200: DeliveryList;
+};
+export type ListDeliveriesResponse = ListDeliveriesResponses[keyof ListDeliveriesResponses];
+export type GetDeliveryByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Stable Mocart delivery-run document id.
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Optional relation expansion. `items` joins the run's per-asset items into an `items` array (each a `DeliveryItem` with its live `permalinkUrl`). Absent by default; an unknown expand token is IGNORED (not a 422).
+         */
+        expand?: 'items';
+    };
+    url: '/deliveries/{id}';
+};
+export type GetDeliveryByIdErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked, or expired bearer token — or the token owner no longer holds the required entitlement (`ENTITLEMENT_LOST`). A uniform problem body is returned with a distinct `code`; no owner/condition detail (no-leak).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The token does not carry the required scope (`API_TOKEN_SCOPE_DENIED`).
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found. No delivery matched the identifier (`DELIVERY_RUN_NOT_FOUND`). A cross-tenant or soft-deleted delivery id returns this SAME uniform 404 (no-leak).
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests. The per-token sliding window of 200 requests/minute was exceeded. The body is express-rate-limit's DEFAULT plain-text message (NOT the JSON problem+json envelope).
+     */
+    429: string;
+};
+export type GetDeliveryByIdError = GetDeliveryByIdErrors[keyof GetDeliveryByIdErrors];
+export type GetDeliveryByIdResponses = {
+    /**
+     * OK. The single delivery.
+     */
+    200: Delivery;
+};
+export type GetDeliveryByIdResponse = GetDeliveryByIdResponses[keyof GetDeliveryByIdResponses];
+export type ListRunsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Page size (default 50).
+         */
+        limit?: string;
+        /**
+         * Opaque cursor from a prior page's `pagination.nextCursor`; pass it back verbatim.
+         */
+        cursor?: string;
+    };
+    url: '/runs';
+};
+export type ListRunsErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content (`VALIDATION_ERROR`). A field has the wrong type or range, or is unknown; every offending field is listed in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 120 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type ListRunsError = ListRunsErrors[keyof ListRunsErrors];
+export type ListRunsResponses = {
+    /**
+     * A page of runs.
+     */
+    200: RunList;
+};
+export type ListRunsResponse = ListRunsResponses[keyof ListRunsResponses];
+export type CreateRunData = {
+    /**
+     * The recipe: which products, which style, and how many creatives of which kind.
+     */
+    body: CreateRunRequest;
+    headers: {
+        /**
+         * One unique value (16–255 characters) per logical request. A retry with the same key and body returns the same run and is never charged twice.
+         */
+        'Idempotency-Key': string;
+    };
+    path?: never;
+    query?: never;
+    url: '/runs';
+};
+export type CreateRunErrors = {
+    /**
+     * Bad Request. A cross-field rule failed (`VALIDATION_ERROR`, naming the fix), the run has more items than the plan allows (`TOO_MANY_ITEMS`), or a product has no primary image (`NO_PRIMARY_IMAGE`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found (`PRODUCTS_NOT_IN_CATALOG`). Every product id not in the account's catalog is named.
+     */
+    404: ProblemDetails;
+    /**
+     * Conflict. The quote exceeds `maxCredits` (`PRICE_EXCEEDS_MAX`) or differs from `expectedTotalCredits` (`PRICE_CHANGED`); the run does not fit what is left of the account's daily API credit budget (`ACCOUNT_SPEND_CAP_EXCEEDED`, with the numbers and the reset instant in `budget`); a create with this key is still in progress (`IDEMPOTENCY_IN_PROGRESS`, retry shortly); or the key was used for a different request (`IDEMPOTENCY_KEY_REUSED`). A budget refusal burns no key.
+     */
+    409: ProblemDetails;
+    /**
+     * Unprocessable Content (`VALIDATION_ERROR`). A field has the wrong type or range, or is unknown; every offending field is listed in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 20 requests per minute on this key.
+     */
+    429: ProblemDetails;
+    /**
+     * Service Unavailable (`CREATE_API_DISABLED`). New runs are paused; existing runs can still be read. Or (`ACCOUNT_SPEND_UNAVAILABLE`) the account's daily API credit budget could not be checked, so nothing was created. Retry after the `Retry-After` interval.
+     */
+    503: ProblemDetails;
+};
+export type CreateRunError = CreateRunErrors[keyof CreateRunErrors];
+export type CreateRunResponses = {
+    /**
+     * Accepted — or the replay of an earlier create with this key.
+     */
+    202: Run;
+};
+export type CreateRunResponse = CreateRunResponses[keyof CreateRunResponses];
+export type EstimateRunData = {
+    /**
+     * The recipe: which products, which style, and how many creatives of which kind.
+     */
+    body: CreateRunRequest;
+    path?: never;
+    query?: never;
+    url: '/runs/estimate';
+};
+export type EstimateRunErrors = {
+    /**
+     * Bad Request. A cross-field rule failed (`VALIDATION_ERROR`, naming the fix), the run has more items than the plan allows (`TOO_MANY_ITEMS`), or a product has no primary image (`NO_PRIMARY_IMAGE`).
+     */
+    400: ProblemDetails;
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found (`PRODUCTS_NOT_IN_CATALOG`). Every product id not in the account's catalog is named.
+     */
+    404: ProblemDetails;
+    /**
+     * Conflict. The quote exceeds `maxCredits` (`PRICE_EXCEEDS_MAX`) or differs from `expectedTotalCredits` (`PRICE_CHANGED`). Nothing was written or charged.
+     */
+    409: ProblemDetails;
+    /**
+     * Unprocessable Content (`VALIDATION_ERROR`). A field has the wrong type or range, or is unknown; every offending field is listed in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 120 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type EstimateRunError = EstimateRunErrors[keyof EstimateRunErrors];
+export type EstimateRunResponses = {
+    /**
+     * The quote this recipe would be created at.
+     */
+    200: RunEstimate;
+};
+export type EstimateRunResponse = EstimateRunResponses[keyof EstimateRunResponses];
+export type ListPresetsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/presets';
+};
+export type ListPresetsErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Unprocessable Content (`VALIDATION_ERROR`). A field has the wrong type or range, or is unknown; every offending field is listed in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 120 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type ListPresetsError = ListPresetsErrors[keyof ListPresetsErrors];
+export type ListPresetsResponses = {
+    /**
+     * Every available preset.
+     */
+    200: RunPresetList;
+};
+export type ListPresetsResponse = ListPresetsResponses[keyof ListPresetsResponses];
+export type GetRunData = {
+    body?: never;
+    path: {
+        /**
+         * The `runId` returned by `POST /runs`.
+         */
+        runId: string;
+    };
+    query?: never;
+    url: '/runs/{runId}';
+};
+export type GetRunErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found (`RUN_NOT_FOUND`). No run with this id belongs to the key's account.
+     */
+    404: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 120 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type GetRunError = GetRunErrors[keyof GetRunErrors];
+export type GetRunResponses = {
+    /**
+     * The run.
+     */
+    200: Run;
+};
+export type GetRunResponse = GetRunResponses[keyof GetRunResponses];
+export type ListRunItemsData = {
+    body?: never;
+    path: {
+        /**
+         * The `runId` returned by `POST /runs`.
+         */
+        runId: string;
+    };
+    query?: {
+        /**
+         * Page size (default 50).
+         */
+        limit?: string;
+        /**
+         * Opaque cursor from a prior page's `pagination.nextCursor`; pass it back verbatim.
+         */
+        cursor?: string;
+    };
+    url: '/runs/{runId}/items';
+};
+export type ListRunItemsErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found (`RUN_NOT_FOUND`). No run with this id belongs to the key's account.
+     */
+    404: ProblemDetails;
+    /**
+     * Unprocessable Content (`VALIDATION_ERROR`). A field has the wrong type or range, or is unknown; every offending field is listed in `errors[]`.
+     */
+    422: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 120 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type ListRunItemsError = ListRunItemsErrors[keyof ListRunItemsErrors];
+export type ListRunItemsResponses = {
+    /**
+     * A page of items.
+     */
+    200: RunItemList;
+};
+export type ListRunItemsResponse = ListRunItemsResponses[keyof ListRunItemsResponses];
+export type StopRunData = {
+    body?: never;
+    path: {
+        /**
+         * The `runId` returned by `POST /runs`.
+         */
+        runId: string;
+    };
+    query?: never;
+    url: '/runs/{runId}/stop';
+};
+export type StopRunErrors = {
+    /**
+     * Unauthorized. Missing, malformed, unknown, revoked or expired bearer token — or the key owner no longer holds the Create API entitlement (`CREATE_API_ENTITLEMENT_LOST`).
+     */
+    401: ProblemDetails;
+    /**
+     * Forbidden. The key lacks the required scope (`API_TOKEN_SCOPE_DENIED`): reads need `runs:read`, creating and stopping need `runs:write`.
+     */
+    403: ProblemDetails;
+    /**
+     * Not Found (`RUN_NOT_FOUND`). No run with this id belongs to the key's account.
+     */
+    404: ProblemDetails;
+    /**
+     * Conflict (`RUN_ALREADY_FINAL`). The run has already finished.
+     */
+    409: ProblemDetails;
+    /**
+     * Too Many Requests (`RATE_LIMITED`). More than 20 requests per minute on this key.
+     */
+    429: ProblemDetails;
+};
+export type StopRunError = StopRunErrors[keyof StopRunErrors];
+export type StopRunResponses = {
+    /**
+     * Stop accepted.
+     */
+    202: Run;
+};
+export type StopRunResponse = StopRunResponses[keyof StopRunResponses];
+/**
+ * The RunCompletedEvent envelope delivered by Svix (Standard Webhooks).
+ */
+export type RunCompletedWebhookWebhookPayload = RunCompletedEvent;
+export type RunCompletedWebhookWebhookRequest = {
+    body: RunCompletedWebhookWebhookPayload;
+    key: 'run.completed';
+    path?: never;
+    query?: never;
+};
+//# sourceMappingURL=types.gen.d.ts.map