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

# Add or remove a tag on a mailbox

> Adds or removes one tag. Tags are cleaned (quotes and backslashes dropped, max 40 chars, max 20 tags per mailbox). An empty tag after cleaning does nothing.

**Minimum role:** `edit` (`x-min-role`). **Destructive:** `false` (`x-destructive`).



## OpenAPI

````yaml /openapi.json post /mailboxes/{mailbox_id}/tags
openapi: 3.0.3
info:
  title: Sales Sequencer API
  version: '1'
  description: >-
    Every Sales Sequencer action over HTTP. Each call runs as the API key's
    creator, with that user's role, in the key's workspace. Auth: X-API-Key
    header.
servers:
  - url: https://api.salessequencer.com/api/v1
security:
  - key: []
paths:
  /mailboxes/{mailbox_id}/tags:
    post:
      tags:
        - Mailboxes
      summary: Add or remove a tag on a mailbox
      description: >-
        Adds or removes one tag. Tags are cleaned (quotes and backslashes
        dropped, max 40 chars, max 20 tags per mailbox). An empty tag after
        cleaning does nothing.


        **Minimum role:** `edit` (`x-min-role`). **Destructive:** `false`
        (`x-destructive`).
      operationId: mailboxes_mailbox_tags
      parameters:
        - in: path
          name: mailbox_id
          required: true
          schema:
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              properties:
                op:
                  description: add or remove. Default add.
                  type: string
                tag:
                  description: Tag text.
                  type: string
              required:
                - tag
              type: object
      responses:
        '200':
          description: Redirect back to the referring page (no flash).
components:
  securitySchemes:
    key:
      in: header
      name: X-API-Key
      type: apiKey

````

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