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

# Get Expert by ID

> Retrieve a specific expert by its ID. Only available for Agencies and Middleware Partners.

<Note>
  **Permission Required:** This endpoint is only available for **Agencies** and **Middleware Partners**.
</Note>


## OpenAPI

````yaml get /v1/get_expert/{expert_id}
openapi: 3.1.0
info:
  title: LangGraph Platform
  version: 0.1.0
servers:
  - url: https://api.b-bot.space/api/v2/
security:
  - apiKey: []
tags:
  - name: Distribution Channels
    description: >-
      A distribution channel is a configured instance of a graph. Distribution
      channels control where and how your AI agents are deployed (Chat, Embed,
      Template, etc.).
  - name: Experts
    description: >-
      Expert CRUD operations for managing AI experts. Only available for
      Agencies and Middleware Partners.
  - name: Threads
    description: A thread contains the accumulated outputs of a group of runs.
  - name: Thread Runs
    description: >-
      A run is an invocation of a graph / assistant on a thread. It updates the
      state of the thread.
  - name: Stateless Runs
    description: >-
      A run is an invocation of a graph / assistant, with no state or memory
      persistence.
  - name: Crons (Plus tier)
    description: >-
      A cron is a periodic run that recurs on a given schedule. The repeats can
      be isolated, or share state in a thread
  - name: Store
    description: >-
      Store is an API for managing persistent key-value store (long-term memory)
      that is available from any thread.
  - name: A2A
    description: >-
      Agent-to-Agent Protocol related endpoints for exposing assistants as
      A2A-compliant agents.
  - name: MCP
    description: >-
      Model Context Protocol related endpoints for exposing an agent as an MCP
      server.
  - name: System
    description: System endpoints for health checks, metrics, and server information.
paths:
  /v1/get_expert/{expert_id}:
    get:
      tags:
        - Experts
      summary: Get Expert by ID
      description: >-
        Retrieve a specific expert by its ID. Only available for Agencies and
        Middleware Partners.
      operationId: get_expert_v1_get_expert__expert_id__get
      parameters:
        - name: expert_id
          in: path
          required: true
          schema:
            type: integer
            title: Expert ID
            description: The unique identifier of the expert
        - name: bbot_api_key
          in: header
          required: true
          schema:
            type: string
            title: B-Bot API Key
            description: API Key for authentication
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  expert:
                    $ref: '#/components/schemas/ExpertDetailed'
        '403':
          description: Invalid API key or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Expert not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ExpertDetailed:
      type: object
      title: Expert Detailed
      description: Detailed expert information with full relations
      allOf:
        - $ref: '#/components/schemas/Expert'
        - type: object
          properties:
            attributes:
              type: object
              properties:
                owner:
                  type: object
                  description: Owner user information
                  properties:
                    data:
                      type: object
                      properties:
                        id:
                          type: integer
                        attributes:
                          type: object
                          properties:
                            username:
                              type: string
                profile_picture:
                  type: object
                  description: Profile picture metadata
                  properties:
                    data:
                      type: object
                      properties:
                        id:
                          type: integer
                        attributes:
                          type: object
                          properties:
                            url:
                              type: string
                            name:
                              type: string
    ErrorResponse:
      type: string
      title: ErrorResponse
      description: Error message returned from the server
    Expert:
      type: object
      title: Expert
      description: Basic expert information
      properties:
        id:
          type: integer
          description: Unique expert identifier
        attributes:
          type: object
          properties:
            name:
              type: string
              description: Expert name
            description:
              type: string
              description: Expert description
            profession:
              type: string
              description: Expert profession/role
            system_message:
              type: string
              description: System instructions for the expert
            function_description:
              type: string
              description: Description of expert's function
            function_name:
              type: string
              description: Function name for API routing
            apps:
              type: array
              description: Connected applications
            experts:
              type: array
              description: Team member expert IDs
            abilities:
              type: array
              description: Expert abilities/skills
            templates:
              type: array
              description: Quick action templates
            knowledge_containers:
              type: array
              description: Linked knowledge bases
            owner:
              type: integer
              description: Owner user ID
            locale:
              type: string
              description: Localization setting
            version:
              type: string
              description: Expert version
            task_assistant_id:
              type: string
              description: Linked task assistant ID
  securitySchemes:
    apiKey:
      type: apiKey
      name: bbot-api-key
      in: header
      description: API key for authentication

````