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

# Delete label



## OpenAPI

````yaml /api-reference/wapilot-developer-api.json delete /labels/{uuid}
openapi: 3.1.0
info:
  title: Wapilot Developer API
  description: >-
    Organization-scoped HTTP API for WhatsApp messaging, contacts, templates,
    labels, and related resources. Authenticate with an **organization API key**
    (Bearer), not a user JWT.
  version: 1.0.0
servers:
  - url: https://your-domain.com/api/v1/api
    description: >-
      Replace `your-domain.com` with your Wapilot backend host (e.g. production
      URL or `http://localhost:8000` for local dev).
security:
  - bearerAuth: []
tags:
  - name: Guide
    description: Unauthenticated API discovery
  - name: Verify
    description: API key check
  - name: Messaging
    description: Send WhatsApp messages (stricter per-org send rate limit)
  - name: Contacts
    description: Contacts and contact–label operations
  - name: Contact groups
    description: Audiences (contact groups)
  - name: Basic replies
    description: Canned / auto-replies
  - name: Templates
    description: WhatsApp template listing and payload for sends
  - name: Chats
    description: Chat list
  - name: Labels
    description: Contact tags (labels)
paths:
  /labels/{uuid}:
    delete:
      tags:
        - Labels
      summary: Delete label
      operationId: deleteLabel
      parameters:
        - name: uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiSuccess_Object'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ApiSuccess_Object:
      allOf:
        - $ref: '#/components/schemas/ApiSuccessBase'
        - type: object
          properties:
            data:
              type: object
              additionalProperties: true
    ApiSuccessBase:
      type: object
      required:
        - status
        - success
        - message
        - data
        - errors
      properties:
        status:
          type: integer
        success:
          const: true
        message:
          type: string
        data:
          description: Response payload
        errors:
          type: array
          items:
            type: object
    ApiErrorEnvelope:
      type: object
      required:
        - status
        - success
        - message
        - data
        - errors
      properties:
        status:
          type: integer
        success:
          const: false
        message:
          type: string
        data:
          type: 'null'
        errors:
          type: array
          items:
            type: object
  responses:
    BadRequest:
      description: Invalid input or business rule (HTTP 400)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorEnvelope'
    Unauthorized:
      description: Missing/invalid key or wrong auth type (HTTP 401)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorEnvelope'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Organization API key
      description: >-
        API key from Developer Tools. Use `Authorization: Bearer <api_key>`.
        **Do not** send a user JWT; it will be rejected with 401.

````