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

# Get agents linked to knowledge base

> Retrieves a list of all agents in your organization that are connected to knowledge bases.
This endpoint helps you understand which agents have knowledge base integrations enabled.
            
**Query Options:**
- Without parameters: Returns all agents with any knowledge base links
- With knowledgeBaseId: Returns only agents linked to the specified knowledge base
            
**Response Format:**
Each item includes:
- Agent ID and name
- List of knowledge base IDs linked to the agent
- Link creation timestamps
            
**Use Cases:**
- Track which agents use specific knowledge bases
- Identify agents that need knowledge base configuration
- Manage knowledge base access across agents



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/knowledge-base/list
openapi: 3.0.4
info:
  title: Dasha BlackBox Agent API
  description: API for managing AI agents and calls
  contact:
    name: DashaAI Team
    email: support@dasha.ai
  version: v1
servers:
  - url: https://blackbox.dasha.ai
    description: Dasha BlackBox Agent API
security:
  - ApiKey: []
  - OAuth: []
tags:
  - name: ActivityLogs
  - name: Agents
  - name: AgentTestCases
  - name: CallResults
  - name: Calls
  - name: Chats
  - name: Copilot
  - name: CustomerData
  - name: Mcp
  - name: Media
  - name: Misc
  - name: PronunciationDictionaries
  - name: Providers
  - name: SipAliases
  - name: SipCredentials
  - name: SipPhoneNumbers
  - name: TextChat
  - name: TwilioProvider
  - name: Voice
  - name: WebhookTest
  - name: WebIntegrations
  - name: WebSocket
    description: WebSocket endpoints for real-time communication
paths:
  /api/v1/agents/knowledge-base/list:
    get:
      tags:
        - Agents
      summary: Get agents linked to knowledge base
      description: >-
        Retrieves a list of all agents in your organization that are connected
        to knowledge bases.

        This endpoint helps you understand which agents have knowledge base
        integrations enabled.
                    
        **Query Options:**

        - Without parameters: Returns all agents with any knowledge base links

        - With knowledgeBaseId: Returns only agents linked to the specified
        knowledge base
                    
        **Response Format:**

        Each item includes:

        - Agent ID and name

        - List of knowledge base IDs linked to the agent

        - Link creation timestamps
                    
        **Use Cases:**

        - Track which agents use specific knowledge bases

        - Identify agents that need knowledge base configuration

        - Manage knowledge base access across agents
      parameters:
        - name: knowledgeBaseId
          in: query
          description: Knowledge base identifier
          schema:
            type: string
      responses:
        '200':
          description: Returns the list of agent links successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AgentsLinksToKnowledgeBaseDTO'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Access denied to organization resources
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred while processing the request
components:
  schemas:
    AgentsLinksToKnowledgeBaseDTO:
      required:
        - agentIds
        - knowledgeBaseId
      type: object
      properties:
        agentIds:
          type: array
          items:
            type: string
          description: >-
            List of agent identifiers that have access to this knowledge base.
            These agents can retrieve information from the knowledge base during
            their conversations.
        knowledgeBaseId:
          minLength: 1
          type: string
          description: >-
            Unique identifier of the knowledge base that the agents are linked
            to.
      additionalProperties: false
      description: >-
        Shows which agents have access to a specific knowledge base. Groups
        agents by knowledge base to display the relationship between knowledge
        bases and the agents configured to use them for RAG (Retrieval-Augmented
        Generation) features.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
  securitySchemes:
    ApiKey:
      type: http
      description: API Key Authentication (Bearer {key})
      scheme: Bearer
    OAuth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://auth.dasha.ai/connect/authorize
          scopes:
            platform_api: Platform API

````