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

# List tags used in workspaces for an agent

> Return a non-paginated list of tags used in documents within workspaces scoped to the specified agent. If the agent is default, tags are computed across all workspaces accessible to the user. If the agent is not default, tags are computed only across workspaces linked to the agent's group, intersected with workspaces accessible to the user.



## OpenAPI

````yaml /api-reference/openapi-v3.yaml get /api/v3/agents/{id}/tags
openapi: 3.0.3
info:
  title: Paradigm API
  version: xenial-xerus (v3)
  description: >-
    A versatile and adaptable tool designed to integrate Generative AI into your
    applications
servers:
  - url: https://paradigm.lighton.ai
security: []
tags:
  - name: Agents
    description: Operations about agents
  - name: Threads
    description: Operations about agents conversation threads
  - name: Tools
    description: Operations about native tools
  - name: Models
    description: Operations about AI models
  - name: MCP
    description: Operations about MCP servers
  - name: Sources
    description: Operations about sources used by agents conversation threads
  - name: Artifacts
    description: Operations about artifacts generated by agents conversation threads
  - name: Agent
    description: >-
      Operations about agents (deprecated). Please use the 'Agents' API
      component instead.
  - name: Files
    description: Operations about files
  - name: Files Processing
    description: Operations about files processing
  - name: Tags
    description: Operations about tags
  - name: Workspaces
    description: Operations about workspaces
  - name: Users
    description: Operations about users
  - name: User Groups
    description: Operations about user groups
  - name: Companies
    description: Operations about companies
  - name: SCIM
    description: Operations about SCIM
paths:
  /api/v3/agents/{id}/tags:
    get:
      tags:
        - Agents
      summary: List tags used in workspaces for an agent
      description: >-
        Return a non-paginated list of tags used in documents within workspaces
        scoped to the specified agent. If the agent is default, tags are
        computed across all workspaces accessible to the user. If the agent is
        not default, tags are computed only across workspaces linked to the
        agent's group, intersected with workspaces accessible to the user.
      operationId: api_v3_agents_tags_list
      parameters:
        - in: query
          name: auto_assign
          schema:
            type: boolean
          description: Filter tags by auto_assign flag
        - in: path
          name: id
          schema:
            type: integer
          description: ID of the agent
          required: true
        - in: query
          name: tag
          schema:
            type: string
          description: Filter tags by tag title (case-insensitive partial match)
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TagListResponseSerializerV3'
          description: ''
      security:
        - bearerAuth: []
components:
  schemas:
    TagListResponseSerializerV3:
      type: object
      description: Serializer for listing tags.
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          description: Tag name
        description:
          type: string
          readOnly: true
          description: Description of the tag (max 500 characters).
        auto_assign:
          type: boolean
          readOnly: true
          description: >-
            If True, this tag can be automatically assigned by the system. If
            False, it can only be assigned by a user.
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: Timestamp when the tag was created.
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: Timestamp when the tag was last updated.
        document_count:
          type: integer
          readOnly: true
          description: Number of visible documents with this tag
      required:
        - auto_assign
        - created_at
        - description
        - document_count
        - id
        - name
        - updated_at
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your auth token.

````