# List Tags

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /tags/list:
    get:
      summary: List Tags
      deprecated: false
      description: Retrieves a list of tags associated with a workspace.
      operationId: Tag_tag/list-all-campaign-and-email-account-tags
      tags:
        - Tags
        - Tag
      parameters:
        - name: workspace_id
          in: query
          description: ''
          required: true
          schema:
            type: string
            description: ''
            default: ''
            examples:
              - 6509f7691205283f2a79f98c
        - name: skip
          in: query
          description: Optional - Offset for pagination
          required: false
          schema:
            type: integer
            description: Optional - Offset for pagination
            default: ''
            examples:
              - ''
        - name: limit
          in: query
          description: Optional - Number of results to return
          required: false
          schema:
            type: integer
            description: Optional - Number of results to return
            default: ''
            examples:
              - ''
        - name: x-api-key
          in: header
          description: Your PlusVibe.ai account's API Key
          required: false
          example: ''
          schema:
            type: string
            description: Your PlusVibe.ai account's API Key
            default: ''
            examples:
              - your-api-key
      responses:
        '200':
          description: A JSON array of tags
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    _id:
                      type: string
                    workspace_id:
                      type: string
                    org_id:
                      type: string
                    name:
                      type: string
                    color:
                      type: string
                    description:
                      type: string
                    status:
                      type: string
                    created_at:
                      type: string
                    modified_at:
                      type: string
                  x-apidog-orders:
                    - _id
                    - workspace_id
                    - org_id
                    - name
                    - color
                    - description
                    - status
                    - created_at
                    - modified_at
              example:
                - _id: 67aa4825311600a4a4b75402
                  workspace_id: 6509f7691205283f2a79f98c
                  org_id: 6509f7691205283f2a79f98b
                  name: Tag 1
                  color: '#18c302'
                  description: ''
                  status: ACTIVE
                  created_at: '2025-02-10T18:40:37.560Z'
                  modified_at: '2025-02-10T18:40:37.560Z'
          headers: {}
          x-apidog-name: OK
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
          headers: {}
          x-apidog-name: Unauthorized
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
          headers: {}
          x-apidog-name: Server Error
      security:
        - ApiKeyAuth: []
          x-apidog:
            schemeGroups:
              - id: uS5KiuC4wfZHK42AzOfA_
                schemeIds:
                  - ApiKeyAuth
            required: true
            use:
              id: uS5KiuC4wfZHK42AzOfA_
            scopes:
              uS5KiuC4wfZHK42AzOfA_:
                ApiKeyAuth: []
      x-apidog-folder: Tags
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-17238036-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: []

```