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

# List Agents

> List all agents for an organization.



## OpenAPI

````yaml get /api/v1/agents
openapi: 3.1.0
info:
  title: ThenaAgentStudio
  description: |2-

        ThenaCrew AI CRM Renewal System

        An intelligent platform to automate customer renewal insights and communications through multi-agent workflows.

        Key Features:
        * AI-powered renewal analysis
        * Personalized communication generation
        * Automated opportunity tracking
        * Multi-agent workflow orchestration
        
  version: 1.0.0
servers:
  - url: https://agent-studio.thena.ai
    description: Production server
  - url: http://localhost:8008
    description: Local development server
security:
  - ApiKeyAuth: []
tags:
  - name: Agents
    description: Agent management endpoints
  - name: Chat
    description: Chat and messaging endpoints
paths:
  /api/v1/agents:
    get:
      tags:
        - Agents
        - Agents
      summary: List Agents
      description: List all agents for an organization.
      operationId: list_agents_api_v1_agents_get
      parameters:
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter agents by status
            title: Status
          description: Filter agents by status
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Agent'
                title: Response List Agents Api V1 Agents Get
        '401':
          description: Unauthorized - Invalid or missing JWT token
        '403':
          description: Forbidden - Insufficient permissions
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Agent:
      properties:
        name:
          type: string
          title: Name
          description: Name of the agent
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Description of the agent's purpose and capabilities
        configuration:
          $ref: '#/components/schemas/AgentConfig'
          description: Agent-specific configuration settings
        avatar_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatar Url
          description: URL of the agent's avatar image
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Additional metadata for the agent
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier for the agent
        template_id:
          type: string
          format: uuid
          title: Template Id
          description: ID of the template this agent was created from
        organization_id:
          type: string
          format: uuid
          title: Organization Id
          description: ID of the organization that owns this agent
        status:
          type: string
          title: Status
          description: Current status of the agent (active, inactive, etc)
        created_at:
          type: string
          title: Created At
          description: When the agent was created
        updated_at:
          type: string
          title: Updated At
          description: When the agent was last updated
        files:
          items:
            $ref: '#/components/schemas/backend__models__agent__AgentFile'
          type: array
          title: Files
          description: List of files associated with this agent
        team_id:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Team Id
          description: List of team IDs this agent belongs to
        completed_flows_count:
          type: integer
          title: Completed Flows Count
          description: Count of successfully completed flow executions
          default: 0
        pending_flows_count:
          type: integer
          title: Pending Flows Count
          description: Count of pending and running flow executions
          default: 0
        bot_sub:
          anyOf:
            - type: string
            - type: 'null'
          title: Bot Sub
          description: Bot subscriber ID used for executing flows
        platform_app_installation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Platform App Installation Id
          description: Platform app installation ID
        platform_app_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Platform App Id
          description: Platform app ID
        platform_app_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Platform App Slug
          description: Platform app slug
      type: object
      required:
        - name
        - configuration
        - id
        - template_id
        - organization_id
        - status
        - created_at
        - updated_at
      title: Agent
      example:
        bot_sub: VVYZYKNJ10E18462MAKTHQRW4C142
        completed_flows_count: 42
        configuration:
          language: English
          team_size: 5
          tone: Professional
        created_at: '2023-01-01T00:00:00Z'
        description: Customized sales assistant for my team
        files: []
        id: 123e4567-e89b-12d3-a456-426614174000
        metadata:
          created_by: admin
          updated_by: admin
        name: My Sales Assistant
        organization_id: 123e4567-e89b-12d3-a456-426614174000
        pending_flows_count: 5
        status: active
        team_id:
          - team-1
          - team-2
        template_id: 123e4567-e89b-12d3-a456-426614174000
        updated_at: '2023-01-01T00:00:00Z'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AgentConfig:
      properties:
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
          description: The specific role/job title of the agent
        goal:
          anyOf:
            - type: string
            - type: 'null'
          title: Goal
          description: Primary objective/purpose of the agent
        backstory:
          anyOf:
            - type: string
            - type: 'null'
          title: Backstory
          description: Background story and context for the agent
        initial_ai_msg:
          anyOf:
            - type: string
            - type: 'null'
          title: Initial Ai Msg
          description: Initial message from the agent
        tone:
          anyOf:
            - type: string
            - type: 'null'
          title: Tone
          description: The emotional tone of the agent's responses
        communication_style:
          type: string
          title: Communication Style
          description: How the agent communicates with others
          default: formal
        personality_traits:
          items:
            type: string
          type: array
          title: Personality Traits
          description: Key personality characteristics
        expertise_level:
          type: string
          title: Expertise Level
          description: Level of expertise in the agent's domain
          default: intermediate
        core_capabilities:
          items:
            type: string
          type: array
          title: Core Capabilities
          description: List of primary skills and capabilities
        knowledge_domains:
          items:
            type: string
          type: array
          title: Knowledge Domains
          description: Specific areas of knowledge
        independence_level:
          type: number
          maximum: 1
          minimum: 0
          title: Independence Level
          description: How independently the agent makes decisions (0-1)
          default: 0.5
        delegation_tendency:
          type: number
          maximum: 1
          minimum: 0
          title: Delegation Tendency
          description: Likelihood to delegate tasks to other agents (0-1)
          default: 0.3
        use_streaming:
          type: boolean
          title: Use Streaming
          description: >-
            Whether to use streaming LLM service instead of CrewAI for message
            processing
          default: false
        collaboration_style:
          additionalProperties:
            type: number
          type: object
          title: Collaboration Style
          description: Weights for different collaboration approaches
        preferred_teammates:
          items:
            type: string
          type: array
          title: Preferred Teammates
          description: List of agent roles this agent works best with
        response_length:
          type: string
          title: Response Length
          description: Preferred length of responses (brief/moderate/detailed)
          default: moderate
        memory_retention:
          type: integer
          minimum: 1
          title: Memory Retention
          description: Number of past interactions to consider
          default: 5
        show_suggestions_after_each_message:
          type: boolean
          title: Show Suggestions After Each Message
          description: Whether to show follow-up suggestions after each assistant message
          default: true
        suggestions_prompt:
          anyOf:
            - type: string
            - type: 'null'
          title: Suggestions Prompt
          description: Custom prompt for generating suggestions
          default: >-
            Based on the conversation history and the most recent assistant
            response, generate ONLY 2 brief follow-up questions the user might
            want to ask. Make these suggestions very concise (max 40 characters
            each), relevant, and helpful. Return ONLY the questions without any
            explanation, each on a new line. DO NOT number the suggestions.
        use_real_time_context:
          type: boolean
          title: Use Real Time Context
          description: Whether to include real-time context from the user's current view
          default: true
        real_time_context_prompt:
          anyOf:
            - type: string
            - type: 'null'
          title: Real Time Context Prompt
          description: Custom prompt explaining the real-time context to the LLM
          default: >-
            You have been supplied with the JSON of the tickets that the user is
            currently seeing on the Thena AI dashboard. Use this ticket
            information to answer accordingly if the user query is related to
            tickets.
        max_context_size:
          type: integer
          title: Max Context Size
          description: Maximum size (in characters) of context data to include
          default: 100000
        use_memory_context:
          type: boolean
          title: Use Memory Context
          description: >-
            Whether to include memory context (entities and facts) from the
            conversation
          default: true
        important_internal_instructions:
          anyOf:
            - type: string
            - type: 'null'
          title: Important Internal Instructions
          description: >-
            Customizable internal instructions for agent response formatting and
            behavior.
        ticket_creation_format:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticket Creation Format
          description: >-
            Customizable format for the agent to use when confirming ticket
            creation.
        user_instructions:
          anyOf:
            - type: string
            - type: 'null'
          title: User Instructions
          description: >-
            Customizable instructions for the user, displayed in the system
            prompt.
        max_iterations:
          type: integer
          title: Max Iterations
          description: Maximum number of iteration attempts for a task
          default: 5
        timeout_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Timeout Seconds
          description: Maximum time allowed for task completion
        tools:
          items:
            type: string
          type: array
          title: Tools
          description: List of tool names this agent can use
        custom_parameters:
          additionalProperties: true
          type: object
          title: Custom Parameters
          description: Additional custom configuration parameters
        chat_widget_instructions:
          anyOf:
            - type: string
            - type: 'null'
          title: Chat Widget Instructions
          description: Customizable instructions specifically for the chat widget context.
      type: object
      title: AgentConfig
    backend__models__agent__AgentFile:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier for the file
        agent_id:
          type: string
          format: uuid
          title: Agent Id
          description: ID of the agent this file belongs to
        organization_id:
          type: string
          format: uuid
          title: Organization Id
          description: ID of the organization that owns this file
        name:
          type: string
          title: Name
          description: Name of the file
        bucket_path:
          type: string
          title: Bucket Path
          description: Path to the file in storage bucket
        size:
          type: integer
          title: Size
          description: Size of the file in bytes
        mime_type:
          type: string
          title: Mime Type
          description: MIME type of the file
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Additional metadata for the file
        created_at:
          type: string
          title: Created At
          description: When the file was created
        updated_at:
          type: string
          title: Updated At
          description: When the file was last updated
      type: object
      required:
        - id
        - agent_id
        - organization_id
        - name
        - bucket_path
        - size
        - mime_type
        - created_at
        - updated_at
      title: AgentFile
      description: Model for an agent file.
      example:
        agent_id: 123e4567-e89b-12d3-a456-426614174000
        bucket_path: agent-id/file-id/document.pdf
        created_at: '2023-01-01T00:00:00Z'
        id: 123e4567-e89b-12d3-a456-426614174000
        metadata:
          has_embeddings: true
          processed_at: '2023-01-01T00:00:00Z'
        mime_type: application/pdf
        name: document.pdf
        organization_id: 123e4567-e89b-12d3-a456-426614174000
        size: 1024
        updated_at: '2023-01-01T00:00:00Z'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````