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

# Delete coupon codes

> Deletes one or more codes from a coupon. Codes that have already been redeemed cannot be deleted; the request fails with the `codes-in-use` error code and returns the offending codes in `errors.coupon_code`.



## OpenAPI

````yaml https://openapi.commercengine.io/ce-admin.json post /offer/coupons/{id}/delete-codes
openapi: 3.1.0
info:
  title: CE Admin APIs
  version: '1.0'
  summary: Comprehensive admin interface for managing your e-commerce platform
  description: >-
    Complete administrative API suite for Commerce Engine, providing powerful
    tools to manage products, orders, customers, inventory, analytics, and
    system configuration. Designed for administrators and backend integrations
    requiring full platform control.
  license:
    name: All Rights Reserved
    url: https://www.commercengine.io/contact-us
  contact:
    email: support@commercengine.io
    url: https://www.commercengine.io/contact-us
    name: Support
servers:
  - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin
    description: Staging Server
    variables:
      store_id:
        default: store_id
        description: Store ID
  - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin
    description: Prod Server
    variables:
      store_id:
        default: store_id
        description: Store ID
security:
  - Authorization: []
tags:
  - name: Analytics
    description: Analytics
  - name: Catalog
    description: Catalog
  - name: Coupons & promotions
    description: Coupons & promotions
  - name: Customers
    description: Customers
  - name: Filter Options
    description: Filter Options
  - name: Inventories
    description: Inventories
  - name: Marketplace
    description: Marketplace
  - name: Marketplace Catalog
    description: Marketplace Catalog
  - name: Media Gallery
    description: Media Gallery
  - name: Metrics
    description: Metrics
  - name: Orders
    description: Orders
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: POS
    description: POS
  - name: Segments
    description: Segments
  - name: Shipping
    description: Shipping
  - name: SSE
    description: SSE
  - name: Store
    description: Store
  - name: Webhooks
    description: Webhooks
paths:
  /offer/coupons/{id}/delete-codes:
    parameters:
      - name: id
        in: path
        description: coupon id
        required: true
        schema:
          type: string
    post:
      tags:
        - Coupons & promotions
      summary: Delete coupon codes
      description: >-
        Deletes one or more codes from a coupon. Codes that have already been
        redeemed cannot be deleted; the request fails with the `codes-in-use`
        error code and returns the offending codes in `errors.coupon_code`.
      operationId: delete-codes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - coupon_code
              properties:
                coupon_code:
                  description: The coupon codes to delete.
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Coupon codes deleted successfully.
                  success:
                    type: boolean
        '400':
          description: Coupon codes could not be deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Cannot delete coupon codes that have been used.
                  success:
                    type: boolean
                    default: false
                  code:
                    type: string
                    example: codes-in-use
                  errors:
                    type: object
                    properties:
                      coupon_code:
                        description: >-
                          The codes that have already been used and therefore
                          cannot be deleted.
                        type: array
                        items:
                          type: string
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````

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