# Delete Multiple Tags

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /tags/delete:
    delete:
      summary: Delete Multiple Tags
      deprecated: false
      description: >
        Deletes one or more tags from the workspace. This operation also removes
        the tags from all associated email accounts and campaigns.


        **Required Fields:**

        - `ids`: Array of tag IDs to delete (minimum 1)


        **Warning:** This operation is irreversible and will:

        - Remove tags from all email accounts

        - Remove tags from all campaigns

        - Update campaign email account lists if affected by tag removal
      tags:
        - Tags
        - Tags
      parameters:
        - name: x-api-key
          in: header
          description: Your PlusVibe.ai account's API Key
          required: false
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - workspace_id
                - ids
              properties:
                workspace_id:
                  type: string
                  pattern: ^[0-9a-fA-F]{24}$
                  description: workspace identifier
                  examples:
                    - 507f1f77bcf86cd799439011
                ids:
                  type: array
                  minItems: 1
                  items:
                    type: string
                    pattern: ^[0-9a-fA-F]{24}$
                    description: MongoDB ObjectId of tag to delete
                  description: Array of tag IDs to delete
                  examples:
                    - - 507f1f77bcf86cd799439012
                      - 507f1f77bcf86cd799439013
              x-apidog-orders:
                - workspace_id
                - ids
            examples:
              delete_multiple:
                value:
                  workspace_id: 507f1f77bcf86cd799439011
                  ids:
                    - 507f1f77bcf86cd799439012
                    - 507f1f77bcf86cd799439013
                    - 507f1f77bcf86cd799439014
                summary: Delete multiple tags
                description: Remove several outdated campaign tags
              delete_single:
                value:
                  workspace_id: 507f1f77bcf86cd799439011
                  ids:
                    - 507f1f77bcf86cd799439015
                summary: Delete single tag
                description: Remove one specific tag
      responses:
        '200':
          description: Tags deleted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                required:
                  - status
                x-apidog-orders:
                  - status
              example:
                status: success
          headers: {}
          x-apidog-name: OK
        '400':
          description: Bad Request - Validation or Business Logic Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - false
                  message:
                    type: string
                    examples:
                      - Validation Error
                  error:
                    type: string
                    examples:
                      - Validation Error
                  errors:
                    type: array
                    items:
                      type: string
                x-apidog-orders:
                  - success
                  - message
                  - error
                  - errors
              examples:
                '2':
                  summary: No tag IDs provided
                  value:
                    success: false
                    message: No tag IDs provided for deletion.
                    error: No tag IDs provided for deletion.
                '3':
                  summary: Invalid tag ID format
                  value:
                    success: false
                    message: Validation Error
                    error: Validation Error
                    errors:
                      - '"ids[0]" length must be 24 characters long'
                '4':
                  summary: Some tags not found or access denied
                  value:
                    success: false
                    message: Some tags not found or access denied.
                    error: Some tags not found or access denied.
          headers: {}
          x-apidog-name: Bad Request
      security: []
      x-apidog-folder: Tags
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-21404675-run
components:
  schemas: {}
  securitySchemes:
    ApiKeyAuth:
      type: apikey
      in: header
      name: x-api-key
      description: |
        API key issued in the PlusVibe dashboard. The server reads it
        from the `x-api-key` header and injects it into the request as
        the `api_key` query parameter, which is why you will see
        `api_key` referenced in validation errors.
    apiKey:
      type: apikey
      in: body
      name: api_key
      description: API key passed in request body
servers:
  - url: https://api.plusvibe.ai/api/v1
    description: Prod Env
security:
  - ApiKeyAuth: []
    x-apidog:
      schemeGroups:
        - id: uS5KiuC4wfZHK42AzOfA_
          schemeIds:
            - ApiKeyAuth
      required: true
      use:
        id: uS5KiuC4wfZHK42AzOfA_
      scopes:
        uS5KiuC4wfZHK42AzOfA_:
          ApiKeyAuth: []

```