> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomarketbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Soft delete an offering

> Marks the offering deleted, forces it INACTIVE and decrements the parent service's `counts.offerings`, once: deleting an unknown or already-deleted offering is a 404 and changes nothing, so a retry is safe. The record is retained so bookings and order items that snapshot it still resolve. Packages built on this offering are not cascaded and keep selling — archive those separately, or a storefront package will quote a session against an offering that no longer appears in the catalogue. Prefer the status route if you only want it off sale, since deletion cannot be undone through the API.



## OpenAPI

````yaml /api-reference/openapi.json delete /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}
openapi: 3.0.0
info:
  title: MarketBox 2.0 Open API
  version: 1.0.0
  description: >-
    The MarketBox public API for building booking experiences. Core model:
    create an order, then draw its order items down into bookings. Single
    bookings reference an order item per service line; package bookings draw one
    PACKAGE item down across N sessions. To schedule a package, build a slate
    (POST /availability/package-slate) and book it by slateId (POST
    /orders/{orderId}/package-bookings). See the guides for end-to-end
    walkthroughs.
  contact:
    name: MarketBox support
servers:
  - url: https://apiv2.gomarketbox.com
    description: MarketBox Open API
security:
  - ApiKeyAuth: []
paths:
  /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}:
    delete:
      tags:
        - ServiceOfferings
      summary: Soft delete an offering
      description: >-
        Marks the offering deleted, forces it INACTIVE and decrements the parent
        service's `counts.offerings`, once: deleting an unknown or
        already-deleted offering is a 404 and changes nothing, so a retry is
        safe. The record is retained so bookings and order items that snapshot
        it still resolve. Packages built on this offering are not cascaded and
        keep selling — archive those separately, or a storefront package will
        quote a session against an offering that no longer appears in the
        catalogue. Prefer the status route if you only want it off sale, since
        deletion cannot be undone through the API.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: >-
              The project (tenant) that owns the resource. Every resource in
              this API is scoped to a project, and your API key is restricted to
              the projects it was issued for — a project outside that scope
              returns 403.
            example: prj_01kv60qgnef2kt3pvqgwmkbzfr
          required: true
          description: >-
            The project (tenant) that owns the resource. Every resource in this
            API is scoped to a project, and your API key is restricted to the
            projects it was issued for — a project outside that scope returns
            403.
          name: projectId
          in: path
        - schema:
            type: string
            minLength: 1
            description: >-
              The service — the sellable thing (a lesson, a treatment).
              Offerings hang off a service and carry the duration and price.
            example: srv_01kv60qg12e82acr78edfnjhvv
          required: true
          description: >-
            The service — the sellable thing (a lesson, a treatment). Offerings
            hang off a service and carry the duration and price.
          name: serviceId
          in: path
        - schema:
            type: string
            minLength: 1
            description: >-
              The offering — one bookable variant of a service, carrying its own
              duration and regional pricing rules.
            example: off_01kv60qge5eh59ap0gw0pqrrys
          required: true
          description: >-
            The offering — one bookable variant of a service, carrying its own
            duration and regional pricing rules.
          name: offeringId
          in: path
      responses:
        '204':
          description: Deleted
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '403':
          description: API key cannot access this project
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
components:
  schemas:
    ErrorMessage:
      type: object
      properties:
        code:
          type: string
          description: Stable machine-readable error code, e.g. NOT_FOUND.
        message:
          type: string
          description: Human-readable description of what went wrong.
        statusCode:
          type: integer
          description: The HTTP status code of this response.
        requestId:
          type: string
          description: >-
            The id of this request, also returned as the X-Request-Id header.
            Quote it in a support ticket.
      required:
        - code
        - message
        - statusCode
        - requestId
      example:
        code: NOT_FOUND
        message: Booking not found
        statusCode: 404
        requestId: a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key minted in the MarketBox dashboard. Scope is restricted to the
        projects you select at creation time. Every route needs the key's
        standard API access (`*`) except `POST /v1/projects/{projectId}/events`,
        which needs `events:write`; a key without `*` is refused with 403
        `CAPABILITY_NOT_GRANTED`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.