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

# Delete a product

> Deletes a product. Returns `422 PRODUCT_HAS_PRICES` when the product still has
associated prices, or `422 PRODUCT_DELETION_UNSUPPORTED` when deletion is disabled
for this resource. To archive a product without deleting, update it with
`active: false`.




## OpenAPI

````yaml /openapi/catalog.yaml delete /products/{id}
openapi: 3.0.3
info:
  title: Ionic Catalog API
  version: '2026-05-01'
  description: >
    Products and prices — the catalog that powers payment links, subscriptions,
    and checkout.


    A product represents a sellable item. Each product carries one or more
    prices that define

    billing amounts and cadences. Prices have immutable `unit_amount` and
    `currency` after

    creation; only `active`, `nickname`, and `metadata` can be updated.


    All monetary amounts are integers in the currency's minor unit (for example
    cents for USD).

    Timestamps are Unix epoch seconds. Identifiers are opaque, prefixed strings:
    products are

    `prod_…` and prices are `price_…`.


    Authentication uses a merchant secret key (`sk_…`) as a bearer token. Read
    endpoints

    require the `products:read` permission; write endpoints require
    `products:write`. The mode

    of the key (test or live) scopes which resources it can see and mutate,
    reflected by each

    resource's `livemode` field.


    Errors are returned as `{ "error": { "code": "...", "message": "..." } }`.
servers:
  - url: '{baseUrl}/v1'
    variables:
      baseUrl:
        default: https://api.ionicfi.com
        description: API base URL for your environment.
security:
  - secretKey: []
tags:
  - name: Products
    description: Create, retrieve, update, and manage catalog products.
  - name: Prices
    description: >-
      Billing amounts attached to products. Amount and currency are immutable
      after creation.
paths:
  /products/{id}:
    parameters:
      - $ref: '#/components/parameters/ProductId'
    delete:
      tags:
        - Products
      summary: Delete a product
      description: >
        Deletes a product. Returns `422 PRODUCT_HAS_PRICES` when the product
        still has

        associated prices, or `422 PRODUCT_DELETION_UNSUPPORTED` when deletion
        is disabled

        for this resource. To archive a product without deleting, update it with

        `active: false`.
      operationId: catalog_products_delete
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      responses:
        '200':
          description: The deleted product marker.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedProduct'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/ProductNotFound'
        '422':
          $ref: '#/components/responses/ProductDeletionFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - secretKey:
            - products:write
components:
  parameters:
    ProductId:
      name: id
      in: path
      required: true
      description: The product id (`prod_…`).
      schema:
        type: string
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        A unique key that makes retries safe: the same key with the same request
        body returns the original response instead of repeating the operation.
      schema:
        type: string
        maxLength: 255
  schemas:
    DeletedProduct:
      type: object
      required:
        - deleted
        - id
        - object
      properties:
        id:
          type: string
        object:
          type: string
          enum:
            - product
        deleted:
          type: boolean
          enum:
            - true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: A stable, machine-readable error code.
            message:
              type: string
  responses:
    BadRequest:
      description: The request was malformed or failed validation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INVALID_REQUEST
              message: invalid request body
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key lacks the required permission, or the merchant is not active.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ProductNotFound:
      description: No product with that id is visible to this key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: PRODUCT_NOT_FOUND
              message: product not found
    ProductDeletionFailed:
      description: >-
        The product cannot be deleted — it still has associated prices
        (`PRODUCT_HAS_PRICES`) or deletion is not supported for this product
        (`PRODUCT_DELETION_UNSUPPORTED`). Deactivate the product with `active:
        false` instead.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: PRODUCT_DELETION_UNSUPPORTED
              message: products cannot be deleted; deactivate the product instead
    RateLimited:
      description: Too many requests. Honour the `Retry-After` header before retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: |
        The API could not return a successful response. For a mutating request,
        retrieve the resource before retrying because the operation may have
        completed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: 'A merchant secret key (`sk_…`) sent as `Authorization: Bearer <key>`.'

````