Tackle Private Offers API

AWS private-offer lifecycle (create, read, update, cancel, push to marketplace).

OpenAPI Specification

tackle-private-offers-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: Tackle Authentication Private Offers API
  description: Authenticated programmatic access to Tackle's webhooks, metering, private offers, and more.
  version: 1.0.0
  contact:
    name: Tackle Support
    email: support@tackle.io
    url: https://tackle.io
servers:
- url: https://api.tackle.io
tags:
- name: Private Offers
  description: AWS private-offer lifecycle (create, read, update, cancel, push to marketplace).
paths:
  /private-offers:
    get:
      summary: List Private Offers
      description: 'Returns a paginated list of private offers visible to the authenticated

        principal. Results may be filtered by status, marketplace, offer type,

        product reference, salesforce opportunity ID, and creation date.


        **Required RBAC permission:** `offers:ListOffers`

        '
      operationId: listPrivateOffers
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      parameters:
      - name: status
        in: query
        required: false
        description: Filter by offer status (e.g. `draft`, `created`, `accepted`, `cancelled`).
        schema:
          type: string
      - name: offer_ref
        in: query
        required: false
        description: Filter by marketplace offer reference (e.g. AWS `offer-*` ID).
        schema:
          type: string
      - name: type
        in: query
        required: false
        description: Filter by offer type.
        schema:
          type: string
          enum:
          - direct
          - partner_resale
      - name: product_ref
        in: query
        required: false
        description: Filter by Tackle product ID.
        schema:
          type: string
      - name: created_at
        in: query
        required: false
        description: Filter to offers created on the given `YYYY-MM-DD` date.
        schema:
          type: string
          format: date
      - name: created_at_gt
        in: query
        required: false
        description: Filter to offers created strictly after the given date.
        schema:
          type: string
          format: date
      - name: created_at_lt
        in: query
        required: false
        description: Filter to offers created strictly before the given date.
        schema:
          type: string
          format: date
      - name: salesforce_opportunity_id
        in: query
        required: false
        description: Filter by associated Salesforce Opportunity ID.
        schema:
          type: string
      - name: sort
        in: query
        required: false
        description: 'Sort expression. Prefix a field name with `-` for descending order

          (e.g. `-created_at`).

          '
        schema:
          type: string
      - name: offset
        in: query
        required: false
        description: Zero-based offset for pagination.
        schema:
          type: integer
          minimum: 0
          default: 0
      - name: limit
        in: query
        required: false
        description: Page size (1–100).
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
      responses:
        '200':
          description: Paginated list of private offers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateOfferList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      summary: Create Private Offer
      description: 'Creates a draft private offer. Set `create_in_marketplace: true` in the

        request body to also push the offer to AWS Marketplace in the same

        call; otherwise the offer is saved as a Tackle draft that can be

        pushed later via `POST /private-offers/{id}/marketplace-create`.


        Set `dry_run: true` to validate the payload without persisting the

        offer; a successful dry run returns `200 OK` instead of `201 Created`.


        **Required RBAC permission:** `offers:CreateDraftOffer`

        '
      operationId: createPrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePrivateOfferRequest'
      responses:
        '200':
          description: Dry-run validation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePrivateOfferResponse'
        '201':
          description: Private offer created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePrivateOfferResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /private-offers/{id}:
    parameters:
    - $ref: '#/components/parameters/PrivateOfferId'
    get:
      summary: Get Private Offer
      description: 'Returns a single private offer by its Tackle ID.


        **Required RBAC permission:** `offers:GetOffer`

        '
      operationId: getPrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      responses:
        '200':
          description: Private offer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateOffer'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      summary: Update Private Offer
      description: 'Updates an existing draft private offer. The body has the same shape as

        `POST /private-offers` (`CreatePrivateOfferRequest`).


        **Required RBAC permission:** `offers:CreateDraftOffer` (the create

        permission also gates updates -- updating a draft is treated as the

        same authorization concept as creating one).

        '
      operationId: updatePrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePrivateOfferRequest'
      responses:
        '200':
          description: Updated private offer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePrivateOfferResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Delete Private Offer
      description: 'Deletes a draft private offer.


        **Required RBAC permission:** `offers:UpdateOffer` (the update

        permission also gates deletes -- "removing a draft" is treated as a

        kind of update).

        '
      operationId: deletePrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      responses:
        '204':
          description: Private offer deleted.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /private-offers/{id}/cancel:
    parameters:
    - $ref: '#/components/parameters/PrivateOfferId'
    post:
      summary: Cancel Private Offer
      description: 'Cancels a private offer that has been pushed to AWS Marketplace but

        not yet accepted by the buyer. The cancellation is performed

        asynchronously; the response indicates that the request has been

        accepted, not that the cancellation is complete. Track completion via

        the offer''s `status` and `activities` fields, or via webhooks.


        **Required RBAC permission:** `offers:CancelOffer`

        '
      operationId: cancelPrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      responses:
        '200':
          description: Cancellation request accepted.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          description: Offer is not in a state that can be cancelled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /private-offers/{id}/marketplace-create:
    parameters:
    - $ref: '#/components/parameters/PrivateOfferId'
    post:
      summary: Push Private Offer to AWS Marketplace
      description: 'Promotes a Tackle draft private offer (one created with

        `create_in_marketplace: false`) into AWS Marketplace. The push is

        asynchronous; this endpoint returns immediately once the request has

        been queued.


        **Required RBAC permission:** `offers:CreateOfferOnMarketplace`

        '
      operationId: marketplaceCreatePrivateOffer
      tags:
      - Private Offers
      security:
      - TackleJwt: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketplaceCreatePrivateOfferRequest'
      responses:
        '200':
          description: Dry-run validation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketplaceCreatePrivateOfferRequest'
        '201':
          description: Marketplace creation request accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketplaceCreatePrivateOfferRequest'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          description: Offer is not eligible for marketplace creation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /api/private-offers/{id}:
    post:
      tags:
      - Private Offers
      summary: Update a Microsoft offer
      description: 'Updates an existing Microsoft private offer. If `status` is

        `submit_to_cloud`, the handler merges EULA documents when present,

        validates the request, and stores the Microsoft submission payload.


        Required RBAC action: `offers:UpdateOffer`. Submitting to Microsoft also

        requires `offers:CreateOfferOnMarketplace`.

        '
      operationId: updatePrivateOffer
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/OfferId'
      - $ref: '#/components/parameters/TackleOperationId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateOffer'
            examples:
              updateDraftOffer:
                summary: Update and keep the offer in Tackle only
                description: 'Use `draft_status` to save the update in Tackle without preparing

                  or submitting a Microsoft marketplace payload.

                  '
                value:
                  status: draft_status
                  name: Updated draft offer
                  description: Updated draft description
              updateCloudOffer:
                summary: Update and submit the offer to Microsoft
                description: 'Use `submit_to_cloud` to validate the offer, merge EULA documents

                  when present, and prepare the Microsoft marketplace payload. This

                  also requires the `offers:CreateOfferOnMarketplace` RBAC action.

                  '
                value:
                  status: submit_to_cloud
                  name: Updated cloud offer
                  description: Updated cloud offer description
                  eula:
                    type: custom
                    document_urns:
                    - document-urn-1
      responses:
        '200':
          description: Offer updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateOffer_2'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError_2'
    get:
      tags:
      - Private Offers
      summary: Get an offer
      description: 'Returns one private offer by Tackle offer ID after checking that the

        caller can access the offer''s vendor.


        Required RBAC action: `offers:GetOffer`.

        '
      operationId: getPrivateOffer
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/OfferId'
      - $ref: '#/components/parameters/TackleOperationId'
      responses:
        '200':
          description: Offer found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateOffer_2'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError_2'
  /api/private-offers:
    post:
      tags:
      - Private Offers
      summary: Create or import a Microsoft offer
      description: 'Creates a new Microsoft private offer from a full offer payload, or

        imports an existing live Microsoft private offer when the body contains

        `microsoftOfferId` and `buyer_company_name`.


        For full create payloads, if `status` is `submit_to_cloud`, the handler

        validates and transforms the request for Microsoft submission before

        saving the offer. For import payloads, the vendor context is derived

        from the authenticated principal; sandbox vendors use their production

        parent vendor''s Microsoft credentials.


        Required RBAC action: `offers:CreateDraftOffer`. Submitting to Microsoft

        also requires `offers:CreateOfferOnMarketplace`.

        '
      operationId: createPrivateOffer
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/TackleOperationId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CreateOffer'
              - $ref: '#/components/schemas/ImportMicrosoftOfferRequest'
            examples:
              createDraftOffer:
                summary: Create a Tackle-only draft
                description: 'Use `draft_status` to save the offer in Tackle without preparing

                  or submitting a Microsoft marketplace payload.

                  '
                value:
                  offer_type: direct
                  vendor_id: vendor-123
                  status: draft_status
                  vendor_name: Example Vendor
                  product_id: product-123
                  product_name: Example Product
                  buyer_details:
                    company_name: Example Buyer
                    billing_account_id: billing-account-123
                  eula:
                    type: standard
                    document_urns: []
                  pricing:
                    plan_name: Example Plan
                    description: Annual plan
                    contract_duration:
                      type: month
                      frequency: 12
                    payment_model: OneTime
                    payment_installments:
                      price_per_payment_in_usd: 1200
                    pricing_type: flat_rate
              createCloudOffer:
                summary: Create and submit to Microsoft
                description: 'Use `submit_to_cloud` to validate the offer and prepare the

                  Microsoft marketplace payload. This also requires the

                  `offers:CreateOfferOnMarketplace` RBAC action.

                  '
                value:
                  offer_type: direct
                  vendor_id: vendor-123
                  status: submit_to_cloud
                  vendor_name: Example Vendor
                  product_id: product-123
                  product_name: Example Product
                  name: Example Microsoft Offer
                  preparer_email: seller@example.com
                  start_on: acceptance
                  end_date: '2027-04-30'
                  accept_by_date: '2026-05-31'
                  buyer_details:
                    company_name: Example Buyer
                    billing_account_id: billing-account-123
                    buyers:
                    - full_name: Buyer User
                      email_address: buyer@example.com
                      title: Procurement
                  eula:
                    type: custom
                    document_urns:
                    - document-urn-1
                  pricing:
                    plan_name: Example Plan
                    description: Annual plan
                    contract_duration:
                      type: month
                      frequency: 12
                    payment_model: OneTime
                    payment_installments:
                      price_per_payment_in_usd: 1200
                    pricing_type: flat_rate
              importMicrosoftOffer:
                summary: Import an existing Microsoft offer
                description: 'Use `microsoftOfferId` with `buyer_company_name` to import an

                  existing live Microsoft private offer into Tackle. Optionally

                  include `salesforce_opportunity_id` to associate the imported

                  offer with a Salesforce opportunity. The Microsoft offer must

                  be supported by Tackle: live state, a single product listing

                  and plan, a single buyer, and supported USD pricing.

                  '
                value:
                  microsoftOfferId: ms-offer-123
                  buyer_company_name: Example Buyer
                  salesforce_opportunity_id: 6000000000001
      responses:
        '200':
          description: Offer created or imported
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateOffer_2'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '500':
          $ref: '#/components/responses/InternalServerError_2'
    get:
      tags:
      - Private Offers
      summary: List offers
      description: 'Finds the authenticated seller''s offers, optionally filtered by Microsoft

        offer reference or Microsoft plan reference. Vendor scope is derived

        from the bearer token; no vendor identifier is accepted from the caller.


        Required RBAC action: `offers:ListOffers`.

        '
      operationId: listPrivateOffers
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/OfferRef'
      - $ref: '#/components/parameters/PlanRef'
      - $ref: '#/components/parameters/TackleOperationId'
      responses:
        '200':
          description: Offers matching the search
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PrivateOffer_2'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '500':
          $ref: '#/components/responses/InternalServerError_2'
components:
  responses:
    Forbidden:
      description: Caller is authenticated but not authorized for this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError_2:
      description: Internal server error or upstream dependency failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequestError:
      description: Invalid request or unsupported operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            message: missing id
    BadRequest:
      description: Request was malformed or failed validation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFoundError:
      description: Requested offer or resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            message: not found
    Unauthorized:
      description: Missing or invalid Tackle JWT.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: An unexpected server error occurred.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource does not exist or is not visible to the caller.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ForbiddenError:
      description: Caller is not allowed to perform this action.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            message: forbidden
    UnauthorizedError:
      description: Authentication failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            message: unauthorized
  schemas:
    ExtraData:
      type: object
      properties:
        users:
          type: array
          description: Users to notify of lifecycle events of the offer.
          items:
            $ref: '#/components/schemas/ExtraDataUser'
    UpdateOffer:
      type: object
      description: Partial request body for updating a Microsoft SaaS private offer.
      properties:
        salesforce:
          oneOf:
          - $ref: '#/components/schemas/UpdateSalesforce'
          - type: 'null'
        marketplace_fee:
          type:
          - number
          - 'null'
          format: double
        state:
          oneOf:
          - $ref: '#/components/schemas/OfferStateValue'
          - type: 'null'
        status:
          description: 'Use `draft_status` to update the offer in Tackle only. Use

            `submit_to_cloud` to validate the update and prepare it for Microsoft

            marketplace submission.

            '
          oneOf:
          - $ref: '#/components/schemas/OfferStatus'
          - type: 'null'
        product_name:
          type:
          - string
          - 'null'
        product_id:
          type:
          - string
          - 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
        pre_registration_details:
          oneOf:
          - $ref: '#/components/schemas/PreRegistrationDetails'
          - type: 'null'
        partner:
          oneOf:
          - $ref: '#/components/schemas/Partner'
          - type: 'null'
        notes:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
        buyer_details:
          oneOf:
          - $ref: '#/components/schemas/UpdateBuyerDetails'
          - type: 'null'
        renewal:
          type:
          - boolean
          - 'null'
        eula:
          oneOf:
          - $ref: '#/components/schemas/EULA_2'
          - type: 'null'
        product_ref:
          type:
          - string
          - 'null'
        users_to_notify:
          type: array
          items:
            $ref: '#/components/schemas/UpdateUserToNotify'
        pricing:
          oneOf:
          - $ref: '#/components/schemas/UpdateOfferPricing'
          - type: 'null'
        preparer_email:
          type:
          - string
          - 'null'
          format: email
        start_on:
          oneOf:
          - $ref: '#/components/schemas/StartOn'
          - type: 'null'
        start_date:
          type:
          - string
          - 'null'
          format: date
        end_date:
          type:
          - string
          - 'null'
          format: date
        accept_by_date:
          type:
          - string
          - 'null'
          format: date
        plan_template:
          oneOf:
          - $ref: '#/components/schemas/PlanTemplate'
          - type: 'null'
    PrivateOfferError:
      type: object
      properties:
        source:
          type: string
        type:
          type: string
        message:
          type: string
    ProductType:
      type: string
      enum:
      - saas
      - ami
      - professional_services
    PositiveTargeting:
      type: object
      description: Positive targeting constraints (currently country allow-lists).
      properties:
        country_codes:
          type: array
          description: ISO 3166-1 alpha-2 country codes the offer is restricted to.
          items:
            type: string
            pattern: ^[A-Z]{2}$
    StartOn:
      type: string
      enum:
      - acceptance
      - custom
    PrivateOfferList:
      type: object
      description: Paginated list of private offers.
      properties:
        private_offers:
          type: array
          items:
            $ref: '#/components/schemas/PrivateOffer'
        offset:
          type: integer
          description: Zero-based offset of the first item in this page.
        limit:
          type: integer
          description: Maximum number of items returned per page.
        total:
          type: integer
          format: int64
          description: Total number of offers matching the query.
      required:
      - private_offers
      - offset
      - limit
      - total
    CreatePrivateOfferRequest:
      type: object
      description: 'Request body for creating or updating a private offer. The wrapper

        controls how the request is processed; the `private_offer` field

        carries the offer payload.


        For AWS, the `private_offer.offer_type` field discriminates the body

        shape:


        - `direct` -- ISV-to-buyer offer.

        - `partner_resale` -- AWS resale (Resale Authorization + CPPO) offer.


        See the `PrivateOffer` schema for the full set of fields supported by

        the `private_offer` body. Conditional validation rules (e.g.

        `service_start_at` is required when `billing_term` is `future_dated`)

        are enforced server-side.

        '
      properties:
        create_in_marketplace:
          type: boolean
          description: 'When `false`, creates a draft offer in Tackle only. When `true`,

            additional marketplace-specific validation is applied and the

            offer is sent to the marketplace after being saved in Tackle.

            '
        send_buyer_instructions:
          type: boolean
          description: 'Whether the buyer should receive purchase-instructions email

            immediately after the offer is created. Must be `true` for AWS

            offers that are pushed to marketplace.

            '
        dry_run:
          type: boolean
          description: 'When `true`, validates the payload without saving it or sending

            it to the marketplace. A successful dry run returns `200`; a

            successful real run returns `201`.

            '
        vendorid:
          type: string
          nullable: true
          description: 'Vendor ID to use for the offer. Inferred from the bearer token

            when omitted.

            '
        private_offer:
          allOf:
          - $ref: '#/components/schemas/PrivateOffer'
          description: The offer payload. See `PrivateOffer` for full field documentation.
      required:
      - create_in_marketplace
      - send_buyer_instructions
      - dry_run
      - private_offer
    PrivateOffer_2:
      type: object
      description: Stored Tackle Microsoft private offer.
      properties:
        po_id:
          type: string
        accepted_at:
          type:
          - string
          - 'null'
          format: date-time
        accepted_source:
          type:
          - string
          - 'null'
        archived_at:
          type:
          - string
          - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
        cancelled_at:
          type:
          - string
          - 'null'
          format: date-time
        last_modified_at:
          type: string
          format: date-time
        last_update_source:
          type:
          - string
          - 'null'
        viewed_offer_at:
          type:
          - string
          - 'null'
          format: date-time
        sent_at:
          type:
          - string
          - 'null'
          format: date-time
        submitted_at:
          type:
          - string
          - 'null'
          format: date-time
        opened_instructions_at:
          type:
          - string
          - 'null'
          format: date-time
        subscribed_at:
          type:
          - string
          - 'null'
          format: date-time
        partner_marked_up_at:
          type:
          - string
          - 'null'
          format: date-time
        marketplace_acceptance_link:
          type:
          - string
          - 'null'
          format: uri
        salesforce:
          $ref: '#/components/schemas/PrivateOfferSalesforce'
        vendor_id:
          type: string
        vendor_name:
          type: string
        product_contact_email:
          type: string
          format: email
        state:
          $ref: '#/components/schemas/OfferStateValue'
        status:
          $ref: '#/components/schemas/OfferStatus'
        offer_type:
          $ref: '#/components/schemas/OfferType'
        marketplace_fee:
          type: number
          format: double
        activities:
          type: array
          items:
            $ref: '#/components/schemas/PrivateOfferActivity'
        archived:
          type: boolean
        version:
          type: string
        product_id:
          type: string
        product_name:
          type: string
        source:
          $ref: '#/components/schemas/Source'
        marketplace_created_at:
          type:
          - string
          - 'null'
          format: date-time
        clone:
          oneOf:
          - $ref: '#/components/schemas/Clone'
          - type: 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
        product_type:
          $ref: '#/components/schemas/ProductType'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/PrivateOfferError'
        pre_registration_details:
          $ref: '#/components/schemas/PreRegistrationDetails'
        ui_state:
          $ref: '#/components/schemas

# --- truncated at 32 KB (71 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tackle/refs/heads/main/openapi/tackle-private-offers-api-openapi.yml