@rippling/rippling-sdk 0.2.0-alpha.94 → 0.2.0-alpha.96

package/src/resources/listing.ts

@@ -0,0 +1,2297 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as BusinessPartnersAPI from './business-partners';
+import { APIPromise } from '../core/api-promise';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Developer Platform account and team management
+ */
+export class Listing extends APIResource {
+  /**
+   * A list of listing.
+   *
+   * - Requires: `Developer Program`
+   */
+  list(
+    query: ListingListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ListingListResponsesPageCursorURL, ListingListResponse> {
+    return this._client.getAPIList('/listing/', PageCursorURL<ListingListResponse>, { query, ...options });
+  }
+
+  /**
+   * Create a draft listing.
+   */
+  create(
+    body: ListingCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingCreateResponse> {
+    return this._client.post('/listing/', { body, ...options });
+  }
+
+  /**
+   * Get one Developer Platform listing.
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<ListingRetrieveResponse> {
+    return this._client.get(path`/listing/${id}/`, options);
+  }
+
+  /**
+   * Update the editable draft listing metadata.
+   */
+  update(
+    id: string,
+    body: ListingUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingUpdateResponse> {
+    return this._client.patch(path`/listing/${id}/`, { body, ...options });
+  }
+
+  /**
+   * Submit the active draft listing for review.
+   */
+  submit(
+    listingID: string,
+    body: ListingSubmitParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingSubmitResponse> {
+    return this._client.post(path`/listing/${listingID}/submit/`, { body, ...options });
+  }
+
+  /**
+   * Withdraw the active submission to draft.
+   */
+  withdraw(
+    listingID: string,
+    body: ListingWithdrawParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingWithdrawResponse> {
+    return this._client.post(path`/listing/${listingID}/withdraw/`, { body, ...options });
+  }
+
+  /**
+   * Resubmit a changes-requested listing.
+   */
+  resubmit(
+    listingID: string,
+    body: ListingResubmitParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingResubmitResponse> {
+    return this._client.post(path`/listing/${listingID}/resubmit/`, { body, ...options });
+  }
+
+  /**
+   * Publish a listing that is ready to publish.
+   */
+  publish(
+    listingID: string,
+    body: ListingPublishParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingPublishResponse> {
+    return this._client.post(path`/listing/${listingID}/publish/`, { body, ...options });
+  }
+
+  /**
+   * Delist a published listing.
+   */
+  delist(
+    listingID: string,
+    body: ListingDelistParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListingDelistResponse> {
+    return this._client.post(path`/listing/${listingID}/delist/`, { body, ...options });
+  }
+}
+
+export type ListingListResponsesPageCursorURL = PageCursorURL<ListingListResponse>;
+
+export interface ListingListResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingListResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingListResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingListResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingCreateResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingCreateResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingCreateResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingCreateResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+/**
+ * Meta information for the response.
+ */
+export interface ListingRetrieveResponse extends BusinessPartnersAPI.Meta {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingRetrieveResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingRetrieveResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingRetrieveResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingUpdateResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingUpdateResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingUpdateResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingUpdateResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingSubmitResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingSubmitResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingSubmitResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingSubmitResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingWithdrawResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingWithdrawResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingWithdrawResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingWithdrawResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingResubmitResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingResubmitResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingResubmitResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingResubmitResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingPublishResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingPublishResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingPublishResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingPublishResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingDelistResponse {
+  /**
+   * Creation timestamp.
+   */
+  created_at?: string;
+
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingDelistResponse.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingDelistResponse.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+
+  /**
+   * Last update timestamp.
+   */
+  updated_at?: string;
+}
+
+export namespace ListingDelistResponse {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingListParams {
+  /**
+   * The maximum number of listings to return.
+   */
+  limit?: number;
+
+  /**
+   * The number of listings to skip.
+   */
+  offset?: number;
+}
+
+export interface ListingCreateParams {
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingCreateParams.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingCreateParams.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+}
+
+export namespace ListingCreateParams {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingUpdateParams {
+  /**
+   * The current draft-cycle slot status.
+   */
+  draft_status?: string;
+
+  /**
+   * The current editable or review listing version.
+   */
+  draft_version?: ListingUpdateParams.DraftVersion;
+
+  /**
+   * The current draft-cycle version ID.
+   */
+  draft_version_id?: string;
+
+  /**
+   * The listing icon URL.
+   */
+  icon?: string;
+
+  /**
+   * The listing ID.
+   */
+  listing_id?: string;
+
+  /**
+   * The listing name or display name.
+   */
+  name?: string;
+
+  /**
+   * The publisher company ID that owns this listing.
+   */
+  owner_company_id?: string;
+
+  /**
+   * The current published or delisted listing version.
+   */
+  published_or_delisted_version?: ListingUpdateParams.PublishedOrDelistedVersion;
+
+  /**
+   * The current published slot status.
+   */
+  published_status?: string;
+
+  /**
+   * The current published or delisted version ID.
+   */
+  published_version_id?: string;
+
+  /**
+   * The listing lifecycle status.
+   */
+  status?: string;
+
+  /**
+   * The listing app type.
+   */
+  type?: string;
+}
+
+export namespace ListingUpdateParams {
+  /**
+   * The current editable or review listing version.
+   */
+  export interface DraftVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+
+  /**
+   * The current published or delisted listing version.
+   */
+  export interface PublishedOrDelistedVersion {
+    /**
+     * The listing version ID.
+     */
+    id?: string;
+
+    /**
+     * The package ID tied to this listing.
+     */
+    catalog_binding_id?: string;
+
+    /**
+     * The package version ID selected by this listing version.
+     */
+    catalog_binding_version_id?: string;
+
+    /**
+     * Creation timestamp.
+     */
+    created_at?: string;
+
+    /**
+     * The display name for this version.
+     */
+    display_name?: string;
+
+    /**
+     * The latest notes submitted for review.
+     */
+    latest_submission_notes?: string;
+
+    /**
+     * Listing metadata for this version.
+     */
+    metadata?: unknown;
+
+    /**
+     * Publish timestamp.
+     */
+    published_at?: string;
+
+    /**
+     * The lifecycle status for this version.
+     */
+    status?: string;
+
+    /**
+     * Last update timestamp.
+     */
+    updated_at?: string;
+
+    /**
+     * The publisher-visible version label.
+     */
+    version_name?: string;
+  }
+}
+
+export interface ListingSubmitParams {
+  /**
+   * Optional notes to record with the transition.
+   */
+  notes?: string;
+}
+
+export interface ListingWithdrawParams {
+  /**
+   * Optional notes to record with the transition.
+   */
+  notes?: string;
+}
+
+export interface ListingResubmitParams {
+  /**
+   * Optional notes to record with the transition.
+   */
+  notes?: string;
+}
+
+export interface ListingPublishParams {
+  /**
+   * Optional notes to record with the transition.
+   */
+  notes?: string;
+}
+
+export interface ListingDelistParams {
+  /**
+   * Optional notes to record with the transition.
+   */
+  notes?: string;
+}
+
+export declare namespace Listing {
+  export {
+    type ListingListResponse as ListingListResponse,
+    type ListingCreateResponse as ListingCreateResponse,
+    type ListingRetrieveResponse as ListingRetrieveResponse,
+    type ListingUpdateResponse as ListingUpdateResponse,
+    type ListingSubmitResponse as ListingSubmitResponse,
+    type ListingWithdrawResponse as ListingWithdrawResponse,
+    type ListingResubmitResponse as ListingResubmitResponse,
+    type ListingPublishResponse as ListingPublishResponse,
+    type ListingDelistResponse as ListingDelistResponse,
+    type ListingListResponsesPageCursorURL as ListingListResponsesPageCursorURL,
+    type ListingListParams as ListingListParams,
+    type ListingCreateParams as ListingCreateParams,
+    type ListingUpdateParams as ListingUpdateParams,
+    type ListingSubmitParams as ListingSubmitParams,
+    type ListingWithdrawParams as ListingWithdrawParams,
+    type ListingResubmitParams as ListingResubmitParams,
+    type ListingPublishParams as ListingPublishParams,
+    type ListingDelistParams as ListingDelistParams,
+  };
+}