@apostra/sdk 0.37.0 → 0.39.0

package/dist/generated/client.d.ts

@@ -1,5 +1,9 @@
 import type * as Wire from './types.gen.js';
 import { Transport, type RequestOptions, type ResponseDetails, type WriteRequestOptions } from '../transport.js';
+type OptionalWireField<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> & Partial<Pick<T, Extract<K, keyof T>>> : never;
+export type ConfirmPaymentAuthorityInput = Wire.ConfirmPaymentAuthorityData['body'];
+export type ConfirmPaymentAuthorityResult = Wire.ConfirmPaymentAuthorityResponses[200]['data'];
+export type ConfirmPaymentAuthorityError = Wire.ConfirmPaymentAuthorityErrors[keyof Wire.ConfirmPaymentAuthorityErrors];
 export type DownloadV3PublicDocumentRevisionInput = {
     "documentId": NonNullable<Wire.DownloadV3PublicDocumentRevisionData['path']>["documentId"];
     "revisionId": NonNullable<Wire.DownloadV3PublicDocumentRevisionData['path']>["revisionId"];
@@ -42,9 +46,18 @@ export type GetStatusError = Wire.GetStatusErrors[keyof Wire.GetStatusErrors];
 export type OpenAdvertisersPageInput = Wire.OpenAdvertisersPageData['body'];
 export type OpenAdvertisersPageResult = Wire.OpenAdvertisersPageResponses[200]['data'];
 export type OpenAdvertisersPageError = Wire.OpenAdvertisersPageErrors[keyof Wire.OpenAdvertisersPageErrors];
+export type OpenAgentCertificationPageInput = Wire.OpenAgentCertificationPageData['body'];
+export type OpenAgentCertificationPageResult = Wire.OpenAgentCertificationPageResponses[200]['data'];
+export type OpenAgentCertificationPageError = Wire.OpenAgentCertificationPageErrors[keyof Wire.OpenAgentCertificationPageErrors];
 export type OpenAgentPageInput = Wire.OpenAgentPageData['body'];
 export type OpenAgentPageResult = Wire.OpenAgentPageResponses[200]['data'];
 export type OpenAgentPageError = Wire.OpenAgentPageErrors[keyof Wire.OpenAgentPageErrors];
+export type OpenAgentSourcesPageInput = Wire.OpenAgentSourcesPageData['body'];
+export type OpenAgentSourcesPageResult = Wire.OpenAgentSourcesPageResponses[200]['data'];
+export type OpenAgentSourcesPageError = Wire.OpenAgentSourcesPageErrors[keyof Wire.OpenAgentSourcesPageErrors];
+export type OpenAgentWebhooksPageInput = Wire.OpenAgentWebhooksPageData['body'];
+export type OpenAgentWebhooksPageResult = Wire.OpenAgentWebhooksPageResponses[200]['data'];
+export type OpenAgentWebhooksPageError = Wire.OpenAgentWebhooksPageErrors[keyof Wire.OpenAgentWebhooksPageErrors];
 export type OpenAgentsPageInput = Wire.OpenAgentsPageData['body'];
 export type OpenAgentsPageResult = Wire.OpenAgentsPageResponses[200]['data'];
 export type OpenAgentsPageError = Wire.OpenAgentsPageErrors[keyof Wire.OpenAgentsPageErrors];
@@ -66,9 +79,15 @@ export type OpenCreativeEnginesPageError = Wire.OpenCreativeEnginesPageErrors[ke
 export type OpenCreativeLibraryInput = Wire.OpenCreativeLibraryData['body'];
 export type OpenCreativeLibraryResult = Wire.OpenCreativeLibraryResponses[200]['data'];
 export type OpenCreativeLibraryError = Wire.OpenCreativeLibraryErrors[keyof Wire.OpenCreativeLibraryErrors];
+export type OpenDeveloperHomeInput = Wire.OpenDeveloperHomeData['body'];
+export type OpenDeveloperHomeResult = Wire.OpenDeveloperHomeResponses[200]['data'];
+export type OpenDeveloperHomeError = Wire.OpenDeveloperHomeErrors[keyof Wire.OpenDeveloperHomeErrors];
 export type OpenMediaBuysPageInput = Wire.OpenMediaBuysPageData['body'];
 export type OpenMediaBuysPageResult = Wire.OpenMediaBuysPageResponses[200]['data'];
 export type OpenMediaBuysPageError = Wire.OpenMediaBuysPageErrors[keyof Wire.OpenMediaBuysPageErrors];
+export type OpenMediaPartnersPageInput = Wire.OpenMediaPartnersPageData['body'];
+export type OpenMediaPartnersPageResult = Wire.OpenMediaPartnersPageResponses[200]['data'];
+export type OpenMediaPartnersPageError = Wire.OpenMediaPartnersPageErrors[keyof Wire.OpenMediaPartnersPageErrors];
 export type OpenPageInput = Wire.OpenPageData['body'];
 export type OpenPageResult = Wire.OpenPageResponses[200]['data'];
 export type OpenPageError = Wire.OpenPageErrors[keyof Wire.OpenPageErrors];
@@ -84,10 +103,13 @@ export type OpenVariantGalleryError = Wire.OpenVariantGalleryErrors[keyof Wire.O
 export type RefreshInventorySourceHealthInput = Wire.RefreshInventorySourceHealthData['body'];
 export type RefreshInventorySourceHealthResult = Wire.RefreshInventorySourceHealthResponses[200]['data'];
 export type RefreshInventorySourceHealthError = Wire.RefreshInventorySourceHealthErrors[keyof Wire.RefreshInventorySourceHealthErrors];
-export type RequestBuyerChildAccountInput = Omit<Wire.RequestBuyerChildAccountData['body'], "idempotencyKey"> & Partial<Pick<Wire.RequestBuyerChildAccountData['body'], "idempotencyKey">>;
+export type RequestBuyerChildAccountInput = OptionalWireField<Wire.RequestBuyerChildAccountData['body'], "idempotencyKey">;
 export type RequestBuyerChildAccountResult = Wire.RequestBuyerChildAccountResponses[200]['data'];
 export type RequestBuyerChildAccountError = Wire.RequestBuyerChildAccountErrors[keyof Wire.RequestBuyerChildAccountErrors];
-export type RequestProposalsInput = Omit<Wire.RequestProposalsData['body'], "idempotencyKey"> & Partial<Pick<Wire.RequestProposalsData['body'], "idempotencyKey">>;
+export type RequestPaymentAuthorityInput = Wire.RequestPaymentAuthorityData['body'];
+export type RequestPaymentAuthorityResult = Wire.RequestPaymentAuthorityResponses[200]['data'];
+export type RequestPaymentAuthorityError = Wire.RequestPaymentAuthorityErrors[keyof Wire.RequestPaymentAuthorityErrors];
+export type RequestProposalsInput = OptionalWireField<Wire.RequestProposalsData['body'], "idempotencyKey">;
 export type RequestProposalsResult = Wire.RequestProposalsResponses[200]['data'];
 export type RequestProposalsError = Wire.RequestProposalsErrors[keyof Wire.RequestProposalsErrors];
 export type RequestSellerReportingUpdateInput = Wire.RequestSellerReportingUpdateData['body'];
@@ -129,10 +151,10 @@ export type SaveBuyerAgentError = Wire.SaveBuyerAgentErrors[keyof Wire.SaveBuyer
 export type SaveBuyerOperatorInput = Wire.SaveBuyerOperatorData['body'];
 export type SaveBuyerOperatorResult = Wire.SaveBuyerOperatorResponses[200]['data'];
 export type SaveBuyerOperatorError = Wire.SaveBuyerOperatorErrors[keyof Wire.SaveBuyerOperatorErrors];
-export type SaveCampaignInput = Omit<Wire.SaveCampaignData['body'], "idempotencyKey"> & Partial<Pick<Wire.SaveCampaignData['body'], "idempotencyKey">>;
+export type SaveCampaignInput = OptionalWireField<Wire.SaveCampaignData['body'], "idempotencyKey">;
 export type SaveCampaignResult = Wire.SaveCampaignResponses[200]['data'];
 export type SaveCampaignError = Wire.SaveCampaignErrors[keyof Wire.SaveCampaignErrors];
-export type SaveCatalogInput = Omit<Wire.SaveCatalogData['body'], "idempotencyKey"> & Partial<Pick<Wire.SaveCatalogData['body'], "idempotencyKey">>;
+export type SaveCatalogInput = OptionalWireField<Wire.SaveCatalogData['body'], "idempotencyKey">;
 export type SaveCatalogResult = Wire.SaveCatalogResponses[200]['data'];
 export type SaveCatalogError = Wire.SaveCatalogErrors[keyof Wire.SaveCatalogErrors];
 export type SaveConnectionInput = Wire.SaveConnectionData['body'];
@@ -150,25 +172,28 @@ export type SaveCreativeCollectionError = Wire.SaveCreativeCollectionErrors[keyo
 export type SaveCreativeSessionInput = Wire.SaveCreativeSessionData['body'];
 export type SaveCreativeSessionResult = Wire.SaveCreativeSessionResponses[200]['data'];
 export type SaveCreativeSessionError = Wire.SaveCreativeSessionErrors[keyof Wire.SaveCreativeSessionErrors];
-export type SaveDimensionInput = Wire.SaveDimensionData['body'];
+export type SaveDimensionInput = OptionalWireField<Wire.SaveDimensionData['body'], "idempotencyKey">;
 export type SaveDimensionResult = Wire.SaveDimensionResponses[200]['data'];
 export type SaveDimensionError = Wire.SaveDimensionErrors[keyof Wire.SaveDimensionErrors];
 export type SaveDirectedCampaignSubscriptionInput = Wire.SaveDirectedCampaignSubscriptionData['body'];
 export type SaveDirectedCampaignSubscriptionResult = Wire.SaveDirectedCampaignSubscriptionResponses[200]['data'];
 export type SaveDirectedCampaignSubscriptionError = Wire.SaveDirectedCampaignSubscriptionErrors[keyof Wire.SaveDirectedCampaignSubscriptionErrors];
-export type SaveEventSourceInput = Omit<Wire.SaveEventSourceData['body'], "idempotencyKey"> & Partial<Pick<Wire.SaveEventSourceData['body'], "idempotencyKey">>;
+export type SaveEventSourceInput = OptionalWireField<Wire.SaveEventSourceData['body'], "idempotencyKey">;
 export type SaveEventSourceResult = Wire.SaveEventSourceResponses[200]['data'];
 export type SaveEventSourceError = Wire.SaveEventSourceErrors[keyof Wire.SaveEventSourceErrors];
 export type SaveInventorySourceInput = Wire.SaveInventorySourceData['body'];
 export type SaveInventorySourceResult = Wire.SaveInventorySourceResponses[200]['data'];
 export type SaveInventorySourceError = Wire.SaveInventorySourceErrors[keyof Wire.SaveInventorySourceErrors];
+export type SaveLessonInput = Wire.SaveLessonData['body'];
+export type SaveLessonResult = Wire.SaveLessonResponses[200]['data'];
+export type SaveLessonError = Wire.SaveLessonErrors[keyof Wire.SaveLessonErrors];
 export type SaveLibraryRequestInput = Wire.SaveLibraryRequestData['body'];
 export type SaveLibraryRequestResult = Wire.SaveLibraryRequestResponses[200]['data'];
 export type SaveLibraryRequestError = Wire.SaveLibraryRequestErrors[keyof Wire.SaveLibraryRequestErrors];
 export type SaveMaterialInput = Wire.SaveMaterialData['body'];
 export type SaveMaterialResult = Wire.SaveMaterialResponses[200]['data'];
 export type SaveMaterialError = Wire.SaveMaterialErrors[keyof Wire.SaveMaterialErrors];
-export type SaveMediaBuyInput = Omit<Wire.SaveMediaBuyData['body'], "idempotencyKey"> & Partial<Pick<Wire.SaveMediaBuyData['body'], "idempotencyKey">>;
+export type SaveMediaBuyInput = OptionalWireField<Wire.SaveMediaBuyData['body'], "idempotencyKey">;
 export type SaveMediaBuyResult = Wire.SaveMediaBuyResponses[200]['data'];
 export type SaveMediaBuyError = Wire.SaveMediaBuyErrors[keyof Wire.SaveMediaBuyErrors];
 export type SaveMediaKitInput = Wire.SaveMediaKitData['body'];
@@ -183,9 +208,12 @@ export type SavePlaybookError = Wire.SavePlaybookErrors[keyof Wire.SavePlaybookE
 export type SavePropertyListInput = Wire.SavePropertyListData['body'];
 export type SavePropertyListResult = Wire.SavePropertyListResponses[200]['data'];
 export type SavePropertyListError = Wire.SavePropertyListErrors[keyof Wire.SavePropertyListErrors];
-export type SaveRfpInput = Wire.SaveRfpData['body'];
+export type SaveRfpInput = OptionalWireField<Wire.SaveRfpData['body'], "clientRequestId">;
 export type SaveRfpResult = Wire.SaveRfpResponses[200]['data'];
 export type SaveRfpError = Wire.SaveRfpErrors[keyof Wire.SaveRfpErrors];
+export type SaveRfpTurnInput = OptionalWireField<Wire.SaveRfpTurnData['body'], "clientRequestId">;
+export type SaveRfpTurnResult = Wire.SaveRfpTurnResponses[200]['data'];
+export type SaveRfpTurnError = Wire.SaveRfpTurnErrors[keyof Wire.SaveRfpTurnErrors];
 export type SaveSellerInput = Wire.SaveSellerData['body'];
 export type SaveSellerResult = Wire.SaveSellerResponses[200]['data'];
 export type SaveSellerError = Wire.SaveSellerErrors[keyof Wire.SaveSellerErrors];
@@ -208,6 +236,10 @@ export type UploadCreativeAssetInput = Wire.UploadCreativeAssetData['body'];
 export type UploadCreativeAssetResult = Wire.UploadCreativeAssetResponses[200]['data'];
 export type UploadCreativeAssetError = Wire.UploadCreativeAssetErrors[keyof Wire.UploadCreativeAssetErrors];
 export interface OperationTypes {
+    "confirm_payment_authority": {
+        input: ConfirmPaymentAuthorityInput;
+        result: ConfirmPaymentAuthorityResult;
+    };
     "downloadV3PublicDocumentRevision": {
         input: DownloadV3PublicDocumentRevisionInput;
         result: DownloadV3PublicDocumentRevisionResult;
@@ -248,10 +280,22 @@ export interface OperationTypes {
         input: OpenAdvertisersPageInput;
         result: OpenAdvertisersPageResult;
     };
+    "open_agent_certification_page": {
+        input: OpenAgentCertificationPageInput;
+        result: OpenAgentCertificationPageResult;
+    };
     "open_agent_page": {
         input: OpenAgentPageInput;
         result: OpenAgentPageResult;
     };
+    "open_agent_sources_page": {
+        input: OpenAgentSourcesPageInput;
+        result: OpenAgentSourcesPageResult;
+    };
+    "open_agent_webhooks_page": {
+        input: OpenAgentWebhooksPageInput;
+        result: OpenAgentWebhooksPageResult;
+    };
     "open_agents_page": {
         input: OpenAgentsPageInput;
         result: OpenAgentsPageResult;
@@ -280,10 +324,18 @@ export interface OperationTypes {
         input: OpenCreativeLibraryInput;
         result: OpenCreativeLibraryResult;
     };
+    "open_developer_home": {
+        input: OpenDeveloperHomeInput;
+        result: OpenDeveloperHomeResult;
+    };
     "open_media_buys_page": {
         input: OpenMediaBuysPageInput;
         result: OpenMediaBuysPageResult;
     };
+    "open_media_partners_page": {
+        input: OpenMediaPartnersPageInput;
+        result: OpenMediaPartnersPageResult;
+    };
     "open_page": {
         input: OpenPageInput;
         result: OpenPageResult;
@@ -308,6 +360,10 @@ export interface OperationTypes {
         input: RequestBuyerChildAccountInput;
         result: RequestBuyerChildAccountResult;
     };
+    "request_payment_authority": {
+        input: RequestPaymentAuthorityInput;
+        result: RequestPaymentAuthorityResult;
+    };
     "request_proposals": {
         input: RequestProposalsInput;
         result: RequestProposalsResult;
@@ -408,6 +464,10 @@ export interface OperationTypes {
         input: SaveInventorySourceInput;
         result: SaveInventorySourceResult;
     };
+    "save_lesson": {
+        input: SaveLessonInput;
+        result: SaveLessonResult;
+    };
     "save_library_request": {
         input: SaveLibraryRequestInput;
         result: SaveLibraryRequestResult;
@@ -440,6 +500,10 @@ export interface OperationTypes {
         input: SaveRfpInput;
         result: SaveRfpResult;
     };
+    "save_rfp_turn": {
+        input: SaveRfpTurnInput;
+        result: SaveRfpTurnResult;
+    };
     "save_seller": {
         input: SaveSellerInput;
         result: SaveSellerResult;
@@ -470,6 +534,15 @@ export interface OperationTypes {
     };
 }
 export declare class Apostra extends Transport {
+    /**
+     * Issue the hosted card-capture link for a token from request_payment_authority. Give the link to the cardholder; cards stay off MCP.
+     *
+     * @example
+     * await client.confirmPaymentAuthority(input, { idempotencyKey: 'stable-key' })
+     */
+    confirmPaymentAuthority(input: ConfirmPaymentAuthorityInput, options: WriteRequestOptions): Promise<ConfirmPaymentAuthorityResult>;
+    /** Issue the hosted card-capture link for a token from request_payment_authority. Give the link to the cardholder; cards stay off MCP. Returns the data together with response headers and request ID. */
+    confirmPaymentAuthorityWithResponse(input: ConfirmPaymentAuthorityInput, options: WriteRequestOptions): Promise<ResponseDetails<ConfirmPaymentAuthorityResult>>;
     /**
      * Download a public immutable document revision
      *
@@ -480,22 +553,22 @@ export declare class Apostra extends Transport {
     /** Download a public immutable document revision Returns the data together with response headers and request ID. */
     downloadV3PublicDocumentRevisionWithResponse(input: DownloadV3PublicDocumentRevisionInput, options?: RequestOptions): Promise<ResponseDetails<DownloadV3PublicDocumentRevisionResult>>;
     /**
-     * Generate or refine new image, hosted video, or voice/audio (radio spots, voiceovers) from a saved Creative Engines brief. Reuse actionKey for an identical retry.
+     * Generate variants from a saved brief; use Creative Sessions for voice/audio, radio spots, and voiceovers. Send kind, scope, and variantAction; reuse actionKey only on retries.
      *
      * @example
      * await client.generateVariants(input, { idempotencyKey: 'stable-key' })
      */
     generateVariants(input: GenerateVariantsInput, options: WriteRequestOptions): Promise<GenerateVariantsResult>;
-    /** Generate or refine new image, hosted video, or voice/audio (radio spots, voiceovers) from a saved Creative Engines brief. Reuse actionKey for an identical retry. Returns the data together with response headers and request ID. */
+    /** Generate variants from a saved brief; use Creative Sessions for voice/audio, radio spots, and voiceovers. Send kind, scope, and variantAction; reuse actionKey only on retries. Returns the data together with response headers and request ID. */
     generateVariantsWithResponse(input: GenerateVariantsInput, options: WriteRequestOptions): Promise<ResponseDetails<GenerateVariantsResult>>;
     /**
-     * Read one object by kind plus the id that search returned, or an account singleton with no id. Never guess an id. include adds detail; each include value works only for the kinds that serve it.
+     * Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
      *
      * @example
      * await client.get(input)
      */
     get(input: GetInput, options?: RequestOptions): Promise<GetResult>;
-    /** Read one object by kind plus the id that search returned, or an account singleton with no id. Never guess an id. include adds detail; each include value works only for the kinds that serve it. Returns the data together with response headers and request ID. */
+    /** Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it. Returns the data together with response headers and request ID. */
     getWithResponse(input: GetInput, options?: RequestOptions): Promise<ResponseDetails<GetResult>>;
     /**
      * Read a bounded public immutable document revision
@@ -543,13 +616,13 @@ export declare class Apostra extends Transport {
     /** Show a seller what reporting we received for one buyer media buy, whether each receipt was accepted, and the current computed daily totals. Opens the Media Buy Timeline Glance. Returns the data together with response headers and request ID. */
     getSellerReportingReceiptsWithResponse(input: GetSellerReportingReceiptsInput, options?: RequestOptions): Promise<ResponseDetails<GetSellerReportingReceiptsResult>>;
     /**
-     * Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand.
+     * Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, and next call.
      *
      * @example
      * await client.getStatus(input)
      */
     getStatus(input?: GetStatusInput, options?: RequestOptions): Promise<GetStatusResult>;
-    /** Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. Returns the data together with response headers and request ID. */
+    /** Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, and next call. Returns the data together with response headers and request ID. */
     getStatusWithResponse(input?: GetStatusInput, options?: RequestOptions): Promise<ResponseDetails<GetStatusResult>>;
     /**
      * Open the Advertisers Page: every advertiser with its campaign and draft counts and one next action each. Use it for "show my advertisers" or "where do I start"; the Page self-fetches. To add or set up an advertiser, pass intent: "add". For a text answer use search(kind: "advertiser").
@@ -560,6 +633,15 @@ export declare class Apostra extends Transport {
     openAdvertisersPage(input: OpenAdvertisersPageInput, options?: RequestOptions): Promise<OpenAdvertisersPageResult>;
     /** Open the Advertisers Page: every advertiser with its campaign and draft counts and one next action each. Use it for "show my advertisers" or "where do I start"; the Page self-fetches. To add or set up an advertiser, pass intent: "add". For a text answer use search(kind: "advertiser"). Returns the data together with response headers and request ID. */
     openAdvertisersPageWithResponse(input: OpenAdvertisersPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenAdvertisersPageResult>>;
+    /**
+     * Open one agent’s Test & certify Page: live certification per use case, recent test runs, AdCP 4.0 readiness and capability declarations. Read-only.
+     *
+     * @example
+     * await client.openAgentCertificationPage(input)
+     */
+    openAgentCertificationPage(input: OpenAgentCertificationPageInput, options?: RequestOptions): Promise<OpenAgentCertificationPageResult>;
+    /** Open one agent’s Test & certify Page: live certification per use case, recent test runs, AdCP 4.0 readiness and capability declarations. Read-only. Returns the data together with response headers and request ID. */
+    openAgentCertificationPageWithResponse(input: OpenAgentCertificationPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenAgentCertificationPageResult>>;
     /**
      * Open one agent owned by this Developer account.
      *
@@ -569,6 +651,24 @@ export declare class Apostra extends Transport {
     openAgentPage(input: OpenAgentPageInput, options?: RequestOptions): Promise<OpenAgentPageResult>;
     /** Open one agent owned by this Developer account. Returns the data together with response headers and request ID. */
     openAgentPageWithResponse(input: OpenAgentPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenAgentPageResult>>;
+    /**
+     * Open one agent’s Inventory sources Page: the inventory sources it powers and the health of each. Read-only.
+     *
+     * @example
+     * await client.openAgentSourcesPage(input)
+     */
+    openAgentSourcesPage(input: OpenAgentSourcesPageInput, options?: RequestOptions): Promise<OpenAgentSourcesPageResult>;
+    /** Open one agent’s Inventory sources Page: the inventory sources it powers and the health of each. Read-only. Returns the data together with response headers and request ID. */
+    openAgentSourcesPageWithResponse(input: OpenAgentSourcesPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenAgentSourcesPageResult>>;
+    /**
+     * Open one agent’s Webhooks Page: its recent inbound webhook outcomes, each refusal with its reason. Read-only.
+     *
+     * @example
+     * await client.openAgentWebhooksPage(input)
+     */
+    openAgentWebhooksPage(input: OpenAgentWebhooksPageInput, options?: RequestOptions): Promise<OpenAgentWebhooksPageResult>;
+    /** Open one agent’s Webhooks Page: its recent inbound webhook outcomes, each refusal with its reason. Read-only. Returns the data together with response headers and request ID. */
+    openAgentWebhooksPageWithResponse(input: OpenAgentWebhooksPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenAgentWebhooksPageResult>>;
     /**
      * Open Build an agent for this Developer account.
      *
@@ -606,13 +706,13 @@ export declare class Apostra extends Transport {
     /** Open the Campaigns Page: campaigns with status, flight, and budget; open one for its media buys and creatives. The Page self-fetches, so do not list campaigns in prose. advertiserId scopes to one advertiser; campaignId focuses one campaign. A draft's go-live review is open_campaign_receipt. Returns the data together with response headers and request ID. */
     openCampaignsPageWithResponse(input: OpenCampaignsPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenCampaignsPageResult>>;
     /**
-     * Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms.
+     * Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms. Replaced by open_media_partners_page, which opens the same Page.
      *
      * @example
      * await client.openConnectionsPage(input)
      */
     openConnectionsPage(input: OpenConnectionsPageInput, options?: RequestOptions): Promise<OpenConnectionsPageResult>;
-    /** Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms. Returns the data together with response headers and request ID. */
+    /** Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms. Replaced by open_media_partners_page, which opens the same Page. Returns the data together with response headers and request ID. */
     openConnectionsPageWithResponse(input: OpenConnectionsPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenConnectionsPageResult>>;
     /**
      * Open the buyer Creative Engines Page. Optionally focus an engine, connection, or its secure setup control; the buyer starts setup in the Page, and this does not authorize a provider or start generation.
@@ -633,22 +733,40 @@ export declare class Apostra extends Transport {
     /** Open Creative Library. Use search for a plain object answer. Composer needs campaignId; assembly needs no Creative Engine. To save a draft, use exactly one format: a canonical format such as image, hosted video, or hosted audio, or a seller format. Returns the data together with response headers and request ID. */
     openCreativeLibraryWithResponse(input: OpenCreativeLibraryInput, options: WriteRequestOptions): Promise<ResponseDetails<OpenCreativeLibraryResult>>;
     /**
-     * Open the Seller Media Buys Page. Optionally focus one seller-owned account relationship and its buys or creatives; the Page self-fetches.
+     * Open the Developer home for this Developer account: its agents, their stages and what to do next.
+     *
+     * @example
+     * await client.openDeveloperHome(input)
+     */
+    openDeveloperHome(input: OpenDeveloperHomeInput, options?: RequestOptions): Promise<OpenDeveloperHomeResult>;
+    /** Open the Developer home for this Developer account: its agents, their stages and what to do next. Returns the data together with response headers and request ID. */
+    openDeveloperHomeWithResponse(input: OpenDeveloperHomeInput, options?: RequestOptions): Promise<ResponseDetails<OpenDeveloperHomeResult>>;
+    /**
+     * Open the Seller Media Buys Page. Optionally focus one account relationship or seller account mapping (not both) and its buys or creatives; the Page self-fetches.
      *
      * @example
      * await client.openMediaBuysPage(input)
      */
     openMediaBuysPage(input: OpenMediaBuysPageInput, options?: RequestOptions): Promise<OpenMediaBuysPageResult>;
-    /** Open the Seller Media Buys Page. Optionally focus one seller-owned account relationship and its buys or creatives; the Page self-fetches. Returns the data together with response headers and request ID. */
+    /** Open the Seller Media Buys Page. Optionally focus one account relationship or seller account mapping (not both) and its buys or creatives; the Page self-fetches. Returns the data together with response headers and request ID. */
     openMediaBuysPageWithResponse(input: OpenMediaBuysPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenMediaBuysPageResult>>;
     /**
-     * Open a compatibility Page. source_diagnostics can create or attach the Agent. External hosts may return text. Credentials and authority changes remain human ceremonies.
+     * Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms.
+     *
+     * @example
+     * await client.openMediaPartnersPage(input)
+     */
+    openMediaPartnersPage(input: OpenMediaPartnersPageInput, options?: RequestOptions): Promise<OpenMediaPartnersPageResult>;
+    /** Open the buyer Media Partners Page. Optionally scope to an advertiser or seller; connectionAction "connect" opens that media partner at connection setup without mutating until the user confirms. Returns the data together with response headers and request ID. */
+    openMediaPartnersPageWithResponse(input: OpenMediaPartnersPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenMediaPartnersPageResult>>;
+    /**
+     * Open a compatibility Page. Owners create or attach the Agent in source_diagnostics. External hosts may return text. Credentials and authority changes remain human ceremonies.
      *
      * @example
      * await client.openPage(input)
      */
     openPage(input: OpenPageInput, options?: RequestOptions): Promise<OpenPageResult>;
-    /** Open a compatibility Page. source_diagnostics can create or attach the Agent. External hosts may return text. Credentials and authority changes remain human ceremonies. Returns the data together with response headers and request ID. */
+    /** Open a compatibility Page. Owners create or attach the Agent in source_diagnostics. External hosts may return text. Credentials and authority changes remain human ceremonies. Returns the data together with response headers and request ID. */
     openPageWithResponse(input: OpenPageInput, options?: RequestOptions): Promise<ResponseDetails<OpenPageResult>>;
     /**
      * Open Proposal Pass on one exact immutable RFP turn. Supply the matching rfpId and turnId from save_rfp or get; the Page loads the private response itself.
@@ -678,13 +796,13 @@ export declare class Apostra extends Transport {
     /** Show a saved Creative Session’s variants (find via search/get kind creative_session). Not for generating new variants. Returns the data together with response headers and request ID. */
     openVariantGalleryWithResponse(input: OpenVariantGalleryInput, options?: RequestOptions): Promise<ResponseDetails<OpenVariantGalleryResult>>;
     /**
-     * Rechecks one external sales-agent source with no-spend get_products. Returns evidence IDs and seller readiness; no source configuration or media buy.
+     * Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy.
      *
      * @example
      * await client.refreshInventorySourceHealth(input, { idempotencyKey: 'stable-key' })
      */
     refreshInventorySourceHealth(input: RefreshInventorySourceHealthInput, options: WriteRequestOptions): Promise<RefreshInventorySourceHealthResult>;
-    /** Rechecks one external sales-agent source with no-spend get_products. Returns evidence IDs and seller readiness; no source configuration or media buy. Returns the data together with response headers and request ID. */
+    /** Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy. Returns the data together with response headers and request ID. */
     refreshInventorySourceHealthWithResponse(input: RefreshInventorySourceHealthInput, options: WriteRequestOptions): Promise<ResponseDetails<RefreshInventorySourceHealthResult>>;
     /**
      * Request a Buyer child under the selected Organization. Nothing is created until an Organization administrator approves it on our site; the result is approval_required with a link to show the person. Repeat with the same idempotencyKey and name for the outcome.
@@ -696,13 +814,22 @@ export declare class Apostra extends Transport {
     /** Request a Buyer child under the selected Organization. Nothing is created until an Organization administrator approves it on our site; the result is approval_required with a link to show the person. Repeat with the same idempotencyKey and name for the outcome. Returns the data together with response headers and request ID. */
     requestBuyerChildAccountWithResponse(input: RequestBuyerChildAccountInput, options: WriteRequestOptions): Promise<ResponseDetails<RequestBuyerChildAccountResult>>;
     /**
-     * Request quotes/products. With a MediaBuy cap, only quotes confirming the exact cap are usable. sellerIds fail closed; campaign-only lists use eligible subset. Broadcast needs confirmBroadcast:true.
+     * Stage a card handoff for the organization and return a confirmation token. No link is issued until confirm_payment_authority.
+     *
+     * @example
+     * await client.requestPaymentAuthority(input, { idempotencyKey: 'stable-key' })
+     */
+    requestPaymentAuthority(input: RequestPaymentAuthorityInput, options: WriteRequestOptions): Promise<RequestPaymentAuthorityResult>;
+    /** Stage a card handoff for the organization and return a confirmation token. No link is issued until confirm_payment_authority. Returns the data together with response headers and request ID. */
+    requestPaymentAuthorityWithResponse(input: RequestPaymentAuthorityInput, options: WriteRequestOptions): Promise<ResponseDetails<RequestPaymentAuthorityResult>>;
+    /**
+     * Request quotes/products. With a MediaBuy cap, only quotes confirming the exact cap are usable. sellerIds and sellerAccountIds fail closed; campaign-only lists use eligible subset. Broadcast needs confirmBroadcast:true.
      *
      * @example
      * await client.requestProposals(input, { idempotencyKey: 'stable-key' })
      */
     requestProposals(input: RequestProposalsInput, options: WriteRequestOptions): Promise<RequestProposalsResult>;
-    /** Request quotes/products. With a MediaBuy cap, only quotes confirming the exact cap are usable. sellerIds fail closed; campaign-only lists use eligible subset. Broadcast needs confirmBroadcast:true. Returns the data together with response headers and request ID. */
+    /** Request quotes/products. With a MediaBuy cap, only quotes confirming the exact cap are usable. sellerIds and sellerAccountIds fail closed; campaign-only lists use eligible subset. Broadcast needs confirmBroadcast:true. Returns the data together with response headers and request ID. */
     requestProposalsWithResponse(input: RequestProposalsInput, options: WriteRequestOptions): Promise<ResponseDetails<RequestProposalsResult>>;
     /**
      * Requests a scheduler-run reporting refresh or a bounded replay for one seller media buy. It never polls a provider directly.
@@ -723,22 +850,22 @@ export declare class Apostra extends Transport {
     /** Review a Buyer child under the selected Organization: name, role, capacity, plan coverage, operator, inherited access and other effects. Read-only; nothing is created. Show the review to the person, then call request_buyer_child_account. Returns the data together with response headers and request ID. */
     reviewBuyerChildAccountWithResponse(input: ReviewBuyerChildAccountInput, options?: RequestOptions): Promise<ResponseDetails<ReviewBuyerChildAccountResult>>;
     /**
-     * Rename an existing direct child Account or update settings.company. Never provisions, archives, or changes owners or members; use Account settings for access changes.
+     * Create a child Account (omit id), rename one, or archive or restore it (isArchived). Each is recorded for website approval by an Organization administrator; repeat with the same idempotencyKey for the outcome. dryRun previews. settings.company saves at once. Never changes owners or members.
      *
      * @example
      * await client.saveAccount(input, { idempotencyKey: 'stable-key' })
      */
     saveAccount(input: SaveAccountInput, options: WriteRequestOptions): Promise<SaveAccountResult>;
-    /** Rename an existing direct child Account or update settings.company. Never provisions, archives, or changes owners or members; use Account settings for access changes. Returns the data together with response headers and request ID. */
+    /** Create a child Account (omit id), rename one, or archive or restore it (isArchived). Each is recorded for website approval by an Organization administrator; repeat with the same idempotencyKey for the outcome. dryRun previews. settings.company saves at once. Never changes owners or members. Returns the data together with response headers and request ID. */
     saveAccountWithResponse(input: SaveAccountInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAccountResult>>;
     /**
-     * Save an advertiser or its mappings. Confirm markets/channels with the buyer first (see footprintProposal). `needs_input` = ask the buyer; never recreate to change currency. Use identityContract:confirmed-v1 for brand fixes. resolveBrand looks up public branding. Guide: /v2/setup/v3/identity-setup.
+     * Save an advertiser or mappings. Buyer privateNotes: owning Buyer Account only; /v3/manage-ads#private-advertiser-notes. Confirm markets/channels (footprintProposal); needs_input=ask; never recreate for currency. Brand: identityContract:confirmed-v1; preview: resolveBrand; read advertiser.brandRef.
      *
      * @example
      * await client.saveAdvertiser(input, { idempotencyKey: 'stable-key' })
      */
     saveAdvertiser(input: SaveAdvertiserInput, options: WriteRequestOptions): Promise<SaveAdvertiserResult>;
-    /** Save an advertiser or its mappings. Confirm markets/channels with the buyer first (see footprintProposal). `needs_input` = ask the buyer; never recreate to change currency. Use identityContract:confirmed-v1 for brand fixes. resolveBrand looks up public branding. Guide: /v2/setup/v3/identity-setup. Returns the data together with response headers and request ID. */
+    /** Save an advertiser or mappings. Buyer privateNotes: owning Buyer Account only; /v3/manage-ads#private-advertiser-notes. Confirm markets/channels (footprintProposal); needs_input=ask; never recreate for currency. Brand: identityContract:confirmed-v1; preview: resolveBrand; read advertiser.brandRef. Returns the data together with response headers and request ID. */
     saveAdvertiserWithResponse(input: SaveAdvertiserInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAdvertiserResult>>;
     /**
      * Invite another Organization to exact advertisers, accept/reject an invitation, or revoke a grant. Limited beta: eligible Organization, entitlement, server-side exposure, and direct human-admin authority are required.
@@ -750,22 +877,22 @@ export declare class Apostra extends Transport {
     /** Invite another Organization to exact advertisers, accept/reject an invitation, or revoke a grant. Limited beta: eligible Organization, entitlement, server-side exposure, and direct human-admin authority are required. Returns the data together with response headers and request ID. */
     saveAdvertiserGrantWithResponse(input: SaveAdvertiserGrantInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAdvertiserGrantResult>>;
     /**
-     * Save seller notes and instructions for an exact brand-domain × operator-domain pair. Configuration does not verify the registry; discounts, source routing, sponsored access, and buyer-account trust are read-only.
+     * Seller-only CRM notes for an exact brand × operator pair. Buyers use save_advertiser.privateNotes; see /v3/manage-ads#private-advertiser-notes. Effective discounts, routing, access and trust are read-only.
      *
      * @example
      * await client.saveAdvertiserInstructions(input, { idempotencyKey: 'stable-key' })
      */
     saveAdvertiserInstructions(input: SaveAdvertiserInstructionsInput, options: WriteRequestOptions): Promise<SaveAdvertiserInstructionsResult>;
-    /** Save seller notes and instructions for an exact brand-domain × operator-domain pair. Configuration does not verify the registry; discounts, source routing, sponsored access, and buyer-account trust are read-only. Returns the data together with response headers and request ID. */
+    /** Seller-only CRM notes for an exact brand × operator pair. Buyers use save_advertiser.privateNotes; see /v3/manage-ads#private-advertiser-notes. Effective discounts, routing, access and trust are read-only. Returns the data together with response headers and request ID. */
     saveAdvertiserInstructionsWithResponse(input: SaveAdvertiserInstructionsInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAdvertiserInstructionsResult>>;
     /**
-     * In a Developer account, register a Sales or Creative Agent, or rename an owned Agent. A registration requires an account administrator and an idempotency key. In a Seller account, confirm or correct one Sales Agent product mode.
+     * Confirm a Sales Agent product mode, register a Sales or Creative Agent, or update an owned Agent: rename it or allow certification buys. To connect from a URL, send agentUrl with dryRun: true, show what was read, then send it without dryRun. A connected agent is not yet verified as theirs.
      *
      * @example
      * await client.saveAgent(input, { idempotencyKey: 'stable-key' })
      */
     saveAgent(input: SaveAgentInput, options: WriteRequestOptions): Promise<SaveAgentResult>;
-    /** In a Developer account, register a Sales or Creative Agent, or rename an owned Agent. A registration requires an account administrator and an idempotency key. In a Seller account, confirm or correct one Sales Agent product mode. Returns the data together with response headers and request ID. */
+    /** Confirm a Sales Agent product mode, register a Sales or Creative Agent, or update an owned Agent: rename it or allow certification buys. To connect from a URL, send agentUrl with dryRun: true, show what was read, then send it without dryRun. A connected agent is not yet verified as theirs. Returns the data together with response headers and request ID. */
     saveAgentWithResponse(input: SaveAgentInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAgentResult>>;
     /**
      * File or update a typed ask in the Apostra Support workflow; returns askId. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first.
@@ -786,13 +913,13 @@ export declare class Apostra extends Transport {
     /** Sync first-party CRM audiences for a buyer advertiser. Each audiences[] item may add, remove, or delete members. Returns an operationId; use get(kind: audience, advertiserId: "...") to read match status after it settles. Returns the data together with response headers and request ID. */
     saveAudienceWithResponse(input: SaveAudienceInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveAudienceResult>>;
     /**
-     * Accept Terms, set seller terms, or manage payment authority. Cards stay off MCP.
+     * Accept Terms, set the payment terms sellers are asked for, or accept a plan, answer its offer and change its renewal. Cards stay off MCP.
      *
      * @example
      * await client.saveBilling(input, { idempotencyKey: 'stable-key' })
      */
     saveBilling(input: SaveBillingInput, options: WriteRequestOptions): Promise<SaveBillingResult>;
-    /** Accept Terms, set seller terms, or manage payment authority. Cards stay off MCP. Returns the data together with response headers and request ID. */
+    /** Accept Terms, set the payment terms sellers are asked for, or accept a plan, answer its offer and change its renewal. Cards stay off MCP. Returns the data together with response headers and request ID. */
     saveBillingWithResponse(input: SaveBillingInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveBillingResult>>;
     /**
      * Write seller AI Business Rules. Policy content needs an account admin and both policy fields. Approval auto needs acknowledgeNoHumanReview.
@@ -804,13 +931,13 @@ export declare class Apostra extends Transport {
     /** Write seller AI Business Rules. Policy content needs an account admin and both policy fields. Approval auto needs acknowledgeNoHumanReview. Returns the data together with response headers and request ID. */
     saveBusinessRulesWithResponse(input: SaveBusinessRulesInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveBusinessRulesResult>>;
     /**
-     * Create, rename, reconcile access, change lifecycle, or prepare a human credential handoff for one buyer agent per call.
+     * Create a buyer agent, or with id make one change: name, advertiser access, lifecycle state, or credential handoff.
      *
      * @example
      * await client.saveBuyerAgent(input, { idempotencyKey: 'stable-key' })
      */
     saveBuyerAgent(input: SaveBuyerAgentInput, options: WriteRequestOptions): Promise<SaveBuyerAgentResult>;
-    /** Create, rename, reconcile access, change lifecycle, or prepare a human credential handoff for one buyer agent per call. Returns the data together with response headers and request ID. */
+    /** Create a buyer agent, or with id make one change: name, advertiser access, lifecycle state, or credential handoff. Returns the data together with response headers and request ID. */
     saveBuyerAgentWithResponse(input: SaveBuyerAgentInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveBuyerAgentResult>>;
     /**
      * Save buyer commercial identity. Read get_status; use identityContract:confirmed-v1 for preview and confirmation. Guide: /v2/setup/v3/identity-setup.
@@ -822,22 +949,22 @@ export declare class Apostra extends Transport {
     /** Save buyer commercial identity. Read get_status; use identityContract:confirmed-v1 for preview and confirmation. Guide: /v2/setup/v3/identity-setup. Returns the data together with response headers and request ID. */
     saveBuyerOperatorWithResponse(input: SaveBuyerOperatorInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveBuyerOperatorResult>>;
     /**
-     * Save a campaign. Create needs advertiserId and name; flight and budget are optional. Split inventory choices into separate media buys; presets expand dimensions. To launch, set desiredPhase: active with confirmLaunch: true; omit confirmation to preview. Cancellation never cancels media buys.
+     * Create: advertiserId/name; flight/budget optional. Receipts and launch previews show local/UTC times in the applicable IANA timezone. desiredPhase: active previews; confirmLaunch: true launches. Cancellation is irreversible: desiredPhase: canceled cancels the campaign and every live media buy.
      *
      * @example
      * await client.saveCampaign(input, { idempotencyKey: 'stable-key' })
      */
     saveCampaign(input: SaveCampaignInput, options: WriteRequestOptions): Promise<SaveCampaignResult>;
-    /** Save a campaign. Create needs advertiserId and name; flight and budget are optional. Split inventory choices into separate media buys; presets expand dimensions. To launch, set desiredPhase: active with confirmLaunch: true; omit confirmation to preview. Cancellation never cancels media buys. Returns the data together with response headers and request ID. */
+    /** Create: advertiserId/name; flight/budget optional. Receipts and launch previews show local/UTC times in the applicable IANA timezone. desiredPhase: active previews; confirmLaunch: true launches. Cancellation is irreversible: desiredPhase: canceled cancels the campaign and every live media buy. Returns the data together with response headers and request ID. */
     saveCampaignWithResponse(input: SaveCampaignInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCampaignResult>>;
     /**
-     * Create or replace one flat catalog declaration by catalogId, or archive it with isArchived. URL saves refetch the feed.
+     * Create or replace a catalog: type and exactly one of url (feed URL) or non-empty items are required. If missing, ask the buyer for the feed URL or items before calling. URL saves refetch the feed. To archive, set isArchived: true with identity only; type, url and items are not needed.
      *
      * @example
      * await client.saveCatalog(input, { idempotencyKey: 'stable-key' })
      */
     saveCatalog(input: SaveCatalogInput, options: WriteRequestOptions): Promise<SaveCatalogResult>;
-    /** Create or replace one flat catalog declaration by catalogId, or archive it with isArchived. URL saves refetch the feed. Returns the data together with response headers and request ID. */
+    /** Create or replace a catalog: type and exactly one of url (feed URL) or non-empty items are required. If missing, ask the buyer for the feed URL or items before calling. URL saves refetch the feed. To archive, set isArchived: true with identity only; type, url and items are not needed. Returns the data together with response headers and request ID. */
     saveCatalogWithResponse(input: SaveCatalogInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCatalogResult>>;
     /**
      * Manage seller or creative-engine authorization, accounts and advertiser mappings. Seller-only: reporting, selection, billing, policy, activation.
@@ -858,13 +985,13 @@ export declare class Apostra extends Transport {
     /** Declare publisher domains this Seller sells and its claimed properties. `domains` replaces the complete set; `add`, `remove`, `declareProperties`, and `removeProperties` change named items only. Read authorization; never assume it. Returns the data together with response headers and request ID. */
     saveCoverageWithResponse(input: SaveCoverageInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCoverageResult>>;
     /**
-     * Save creative in advertiserId/campaignId with name, message, assets, clickUrl, social, sourceAssetRef/sourceAssets. Use exactly one format selector: formatKind/formatParams, creativeFormatId, formatOptionRef. Supplied content/assets only; generate new media (radio spots) via save_creative_session.
+     * advertiserId/campaignId:name,message;assets/landing_page_url/social/sourceAssetRef/sourceAssets;Supplied content/assets only;generate new media (radio spots):save_creative_session;exactly one format selector:formatKind/formatParams,creativeFormatId/formatOptionRef;libraryRole:Buyer Account only.
      *
      * @example
      * await client.saveCreative(input, { idempotencyKey: 'stable-key' })
      */
     saveCreative(input: SaveCreativeInput, options: WriteRequestOptions): Promise<SaveCreativeResult>;
-    /** Save creative in advertiserId/campaignId with name, message, assets, clickUrl, social, sourceAssetRef/sourceAssets. Use exactly one format selector: formatKind/formatParams, creativeFormatId, formatOptionRef. Supplied content/assets only; generate new media (radio spots) via save_creative_session. Returns the data together with response headers and request ID. */
+    /** advertiserId/campaignId:name,message;assets/landing_page_url/social/sourceAssetRef/sourceAssets;Supplied content/assets only;generate new media (radio spots):save_creative_session;exactly one format selector:formatKind/formatParams,creativeFormatId/formatOptionRef;libraryRole:Buyer Account only. Returns the data together with response headers and request ID. */
     saveCreativeWithResponse(input: SaveCreativeInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCreativeResult>>;
     /**
      * Manage collections. Create with one owner and name: campaignId or advertiserId. Only advertiser mutations of an existing collection need expectedUpdatedAt; campaign writes and creates do not. isArchived archives or restores advertiser collections.
@@ -876,13 +1003,13 @@ export declare class Apostra extends Transport {
     /** Manage collections. Create with one owner and name: campaignId or advertiserId. Only advertiser mutations of an existing collection need expectedUpdatedAt; campaign writes and creates do not. isArchived archives or restores advertiser collections. Returns the data together with response headers and request ID. */
     saveCreativeCollectionWithResponse(input: SaveCreativeCollectionInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCreativeCollectionResult>>;
     /**
-     * Create image, video, or voice/audio variants from a brief (including radio spots). Scope: campaign/campaignId or advertiser/advertiserId.
+     * Save a Creative Session for image, video, or voice/audio (including radio spots) from a brief: its draft, selected output, approval, or finalisation. It never generates; generate_variants does. To save an approved output to the Library, use save_creative with fromCreativeSessionOutput.
      *
      * @example
      * await client.saveCreativeSession(input, { idempotencyKey: 'stable-key' })
      */
     saveCreativeSession(input: SaveCreativeSessionInput, options: WriteRequestOptions): Promise<SaveCreativeSessionResult>;
-    /** Create image, video, or voice/audio variants from a brief (including radio spots). Scope: campaign/campaignId or advertiser/advertiserId. Returns the data together with response headers and request ID. */
+    /** Save a Creative Session for image, video, or voice/audio (including radio spots) from a brief: its draft, selected output, approval, or finalisation. It never generates; generate_variants does. To save an approved output to the Library, use save_creative with fromCreativeSessionOutput. Returns the data together with response headers and request ID. */
     saveCreativeSessionWithResponse(input: SaveCreativeSessionInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveCreativeSessionResult>>;
     /**
      * Create a dimension, or update an existing dimension by its id. Tags is built in and open. Labels belong only to objects in appliesTo.
@@ -894,13 +1021,13 @@ export declare class Apostra extends Transport {
     /** Create a dimension, or update an existing dimension by its id. Tags is built in and open. Labels belong only to objects in appliesTo. Returns the data together with response headers and request ID. */
     saveDimensionWithResponse(input: SaveDimensionInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveDimensionResult>>;
     /**
-     * Subscribe to a connected seller's directed campaigns, mirroring its media buys into this buyer's view. Set `unsubscribe: true` to remove the subscription and retire mirrored campaigns. Requires a mapped seller account and reachable advertiser.
+     * Import native campaigns from Spotify Ads Manager or other platforms, including future-start campaigns, as read-only mirrors. Confirm ongoing sync first. No provider changes. /v3/import-existing-campaigns.
      *
      * @example
      * await client.saveDirectedCampaignSubscription(input, { idempotencyKey: 'stable-key' })
      */
     saveDirectedCampaignSubscription(input: SaveDirectedCampaignSubscriptionInput, options: WriteRequestOptions): Promise<SaveDirectedCampaignSubscriptionResult>;
-    /** Subscribe to a connected seller's directed campaigns, mirroring its media buys into this buyer's view. Set `unsubscribe: true` to remove the subscription and retire mirrored campaigns. Requires a mapped seller account and reachable advertiser. Returns the data together with response headers and request ID. */
+    /** Import native campaigns from Spotify Ads Manager or other platforms, including future-start campaigns, as read-only mirrors. Confirm ongoing sync first. No provider changes. /v3/import-existing-campaigns. Returns the data together with response headers and request ID. */
     saveDirectedCampaignSubscriptionWithResponse(input: SaveDirectedCampaignSubscriptionInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveDirectedCampaignSubscriptionResult>>;
     /**
      * Create, change, archive, or restore up to 50 advertiser conversion event sources (pixels, server feeds). Each entry is keyed by eventSourceId and succeeds or fails alone. Setup is not proof events flow: check health with get, then use eventSourceId in an optimization goal.
@@ -912,14 +1039,23 @@ export declare class Apostra extends Transport {
     /** Create, change, archive, or restore up to 50 advertiser conversion event sources (pixels, server feeds). Each entry is keyed by eventSourceId and succeeds or fails alone. Setup is not proof events flow: check health with get, then use eventSourceId in an optimization goal. Returns the data together with response headers and request ID. */
     saveEventSourceWithResponse(input: SaveEventSourceInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveEventSourceResult>>;
     /**
-     * Create or update where a seller's inventory comes from. Pass `id` to change an existing source, omit it to add one. Credentials are never passed here — a source that needs a secret comes back with the state and the page that collects it.
+     * Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Pass only `agentId` or `adServer` to open the form that connects an agent or an ad server. Credentials are never passed here; a source that needs one returns the page that collects it.
      *
      * @example
      * await client.saveInventorySource(input, { idempotencyKey: 'stable-key' })
      */
     saveInventorySource(input: SaveInventorySourceInput, options: WriteRequestOptions): Promise<SaveInventorySourceResult>;
-    /** Create or update where a seller's inventory comes from. Pass `id` to change an existing source, omit it to add one. Credentials are never passed here — a source that needs a secret comes back with the state and the page that collects it. Returns the data together with response headers and request ID. */
+    /** Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Pass only `agentId` or `adServer` to open the form that connects an agent or an ad server. Credentials are never passed here; a source that needs one returns the page that collects it. Returns the data together with response headers and request ID. */
     saveInventorySourceWithResponse(input: SaveInventorySourceInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveInventorySourceResult>>;
+    /**
+     * Manage seller lessons in a seller account context; use switch_account first. propose requires lesson; approve and retire require lessonId; preview requires lessonId and brief. Preserve seller words from a private Session note and ask if kind or scope is unclear.
+     *
+     * @example
+     * await client.saveLesson(input, { idempotencyKey: 'stable-key' })
+     */
+    saveLesson(input: SaveLessonInput, options: WriteRequestOptions): Promise<SaveLessonResult>;
+    /** Manage seller lessons in a seller account context; use switch_account first. propose requires lesson; approve and retire require lessonId; preview requires lessonId and brief. Preserve seller words from a private Session note and ask if kind or scope is unclear. Returns the data together with response headers and request ID. */
+    saveLessonWithResponse(input: SaveLessonInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveLessonResult>>;
     /**
      * Open a seller library request or close it with seller Material.
      *
@@ -930,13 +1066,13 @@ export declare class Apostra extends Transport {
     /** Open a seller library request or close it with seller Material. Returns the data together with response headers and request ID. */
     saveLibraryRequestWithResponse(input: SaveLibraryRequestInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveLibraryRequestResult>>;
     /**
-     * Register, revise, archive, restore, or reprocess seller Materials; manage candidate decisions and receipts; mark a slide, page, or sheet reusable only when it has no commercial figures (UNIT_NOT_REUSABLE_KIND rejects document containers, UNIT_CONTAINS_PRICING rejects priced units).
+     * Create or update seller Materials. Seller beta: preview, delete, Undo deletion, or Include again for one imported Library document. Delete archives it, excludes its source until Include again, and purges it after 30 days. https://docs.apostra.com/v3/delete-from-apostra
      *
      * @example
      * await client.saveMaterial(input, { idempotencyKey: 'stable-key' })
      */
     saveMaterial(input: SaveMaterialInput, options: WriteRequestOptions): Promise<SaveMaterialResult>;
-    /** Register, revise, archive, restore, or reprocess seller Materials; manage candidate decisions and receipts; mark a slide, page, or sheet reusable only when it has no commercial figures (UNIT_NOT_REUSABLE_KIND rejects document containers, UNIT_CONTAINS_PRICING rejects priced units). Returns the data together with response headers and request ID. */
+    /** Create or update seller Materials. Seller beta: preview, delete, Undo deletion, or Include again for one imported Library document. Delete archives it, excludes its source until Include again, and purges it after 30 days. https://docs.apostra.com/v3/delete-from-apostra Returns the data together with response headers and request ID. */
     saveMaterialWithResponse(input: SaveMaterialInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveMaterialResult>>;
     /**
      * Create DRAFT buy; no spend until confirmed. Meta: shared campaign=seller_optimized; ad sets=fixed; ask if unclear. Shared: omit buy/product budgets. Pause/resume: mediaBuyId + isPaused. Proposal: flight + total budget; omit products. channelGroupId: required if grouped; invalid ungrouped/updates.
@@ -957,49 +1093,58 @@ export declare class Apostra extends Transport {
     /** Deprecated compatibility tool ("listing" is the modern term). It writes only the legacy businessProfile and does not update the canonical buyer-visible listing. New clients must read with `get({ kind: "seller", include: ["listing"] })` and write with `save_seller`. Returns the data together with response headers and request ID. */
     saveMediaKitWithResponse(input: SaveMediaKitInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveMediaKitResult>>;
     /**
-     * Create or update a notification subscription: scope, content, routes; no trigger type is creatable yet, no delivery policy yet. Omit subscriptionId to create, supply it to patch. Managed subscriptions are editable only within their mutability. Credentials belong to save_integration.
+     * Create or update a notification subscription. Omit subscriptionId to create; managed subscriptions permit only mutable fields. Use save_integration for credentials when needed.
      *
      * @example
      * await client.saveNotificationConfig(input, { idempotencyKey: 'stable-key' })
      */
     saveNotificationConfig(input: SaveNotificationConfigInput, options: WriteRequestOptions): Promise<SaveNotificationConfigResult>;
-    /** Create or update a notification subscription: scope, content, routes; no trigger type is creatable yet, no delivery policy yet. Omit subscriptionId to create, supply it to patch. Managed subscriptions are editable only within their mutability. Credentials belong to save_integration. Returns the data together with response headers and request ID. */
+    /** Create or update a notification subscription. Omit subscriptionId to create; managed subscriptions permit only mutable fields. Use save_integration for credentials when needed. Returns the data together with response headers and request ID. */
     saveNotificationConfigWithResponse(input: SaveNotificationConfigInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveNotificationConfigResult>>;
     /**
-     * Write how the seller sells. `active` creates and activates a new version in one step — no separate activate; the response names the version created and replaced. `pricing` replaces the whole fact list. `discounts` sets or removes brand/operator rules one by one. Halves never roll back each other.
+     * Write selling guidance. `active` turns Playbook prose and its optional seller note into proposed Lessons; the active Playbook is unchanged. `pricing` replaces facts. `discounts` sets or removes brand/operator rules. Halves never roll back each other.
      *
      * @example
      * await client.savePlaybook(input, { idempotencyKey: 'stable-key' })
      */
     savePlaybook(input: SavePlaybookInput, options: WriteRequestOptions): Promise<SavePlaybookResult>;
-    /** Write how the seller sells. `active` creates and activates a new version in one step — no separate activate; the response names the version created and replaced. `pricing` replaces the whole fact list. `discounts` sets or removes brand/operator rules one by one. Halves never roll back each other. Returns the data together with response headers and request ID. */
+    /** Write selling guidance. `active` turns Playbook prose and its optional seller note into proposed Lessons; the active Playbook is unchanged. `pricing` replaces facts. `discounts` sets or removes brand/operator rules. Halves never roll back each other. Returns the data together with response headers and request ID. */
     savePlaybookWithResponse(input: SavePlaybookInput, options: WriteRequestOptions): Promise<ResponseDetails<SavePlaybookResult>>;
     /**
-     * Create, update, archive, or AAO-check an advertiser property list. Check uses identifiers without saving. Search/get read saved lists.
+     * Create, update, archive, restore, or AAO-check an advertiser property list. Check uses identifiers without saving. Search/get read saved lists.
      *
      * @example
      * await client.savePropertyList(input, { idempotencyKey: 'stable-key' })
      */
     savePropertyList(input: SavePropertyListInput, options: WriteRequestOptions): Promise<SavePropertyListResult>;
-    /** Create, update, archive, or AAO-check an advertiser property list. Check uses identifiers without saving. Search/get read saved lists. Returns the data together with response headers and request ID. */
+    /** Create, update, archive, restore, or AAO-check an advertiser property list. Check uses identifiers without saving. Search/get read saved lists. Returns the data together with response headers and request ID. */
     savePropertyListWithResponse(input: SavePropertyListInput, options: WriteRequestOptions): Promise<ResponseDetails<SavePropertyListResult>>;
     /**
-     * Save RFPs and turns: imported origins, typed feedback, response pairs, endorsement, and proposal-file requests.
+     * Save an RFP: create it from an origin, revise it with a new request, endorse or unendorse its response, or attach an imported response. A turn’s feedback, release, proposal files and outcome use save_rfp_turn.
      *
      * @example
      * await client.saveRfp(input, { idempotencyKey: 'stable-key' })
      */
     saveRfp(input: SaveRfpInput, options: WriteRequestOptions): Promise<SaveRfpResult>;
-    /** Save RFPs and turns: imported origins, typed feedback, response pairs, endorsement, and proposal-file requests. Returns the data together with response headers and request ID. */
+    /** Save an RFP: create it from an origin, revise it with a new request, endorse or unendorse its response, or attach an imported response. A turn’s feedback, release, proposal files and outcome use save_rfp_turn. Returns the data together with response headers and request ID. */
     saveRfpWithResponse(input: SaveRfpInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveRfpResult>>;
     /**
-     * Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, or a seller-controlled admission. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:"distribution").
+     * Change one RFP turn: release it, request or cancel a proposal file, append feedback, or record its outcome. One of these per call; revise, endorse and attach a response with save_rfp.
+     *
+     * @example
+     * await client.saveRfpTurn(input, { idempotencyKey: 'stable-key' })
+     */
+    saveRfpTurn(input: SaveRfpTurnInput, options: WriteRequestOptions): Promise<SaveRfpTurnResult>;
+    /** Change one RFP turn: release it, request or cancel a proposal file, append feedback, or record its outcome. One of these per call; revise, endorse and attach a response with save_rfp. Returns the data together with response headers and request ID. */
+    saveRfpTurnWithResponse(input: SaveRfpTurnInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveRfpTurnResult>>;
+    /**
+     * Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, or the intake hold. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:"distribution").
      *
      * @example
      * await client.saveSeller(input, { idempotencyKey: 'stable-key' })
      */
     saveSeller(input: SaveSellerInput, options: WriteRequestOptions): Promise<SaveSellerResult>;
-    /** Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, or a seller-controlled admission. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:"distribution"). Returns the data together with response headers and request ID. */
+    /** Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, or the intake hold. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:"distribution"). Returns the data together with response headers and request ID. */
     saveSellerWithResponse(input: SaveSellerInput, options: WriteRequestOptions): Promise<ResponseDetails<SaveSellerResult>>;
     /**
      * Create, replace, or archive a signal. Managed writes need a complete draft; read before updates. Without sourceId, writes the seller catalog.
@@ -1056,3 +1201,4 @@ export declare class Apostra extends Transport {
     /** Open the embedded Task for an advertiser. Returns accepted MIME types and exact byte limits by type. max_size_bytes is only the largest. Use fallback_url if the Task does not render. Uploading never creates or delivers a Creative. Returns the data together with response headers and request ID. */
     uploadCreativeAssetWithResponse(input: UploadCreativeAssetInput, options: WriteRequestOptions): Promise<ResponseDetails<UploadCreativeAssetResult>>;
 }
+export {};