> ## 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.

# Create Expert

> Create a new expert in the B-Bot system. Only available for Agencies and Middleware Partners.

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


## OpenAPI

````yaml post /v1/create_expert
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/create_expert:
    post:
      tags:
        - Experts
      summary: Create Expert
      description: >-
        Create a new expert in the B-Bot system. Only available for Agencies and
        Middleware Partners.
      operationId: create_expert_v1_create_expert_post
      parameters:
        - name: bbot_api_key
          in: header
          required: true
          schema:
            type: string
            title: B-Bot API Key
            description: API Key for authentication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExpertCreate'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Created expert ID
                  attributes:
                    type: object
                    description: Expert attributes
        '400':
          description: Missing required fields or invalid data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Invalid API key or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: User not found in datacenter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to create expert
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ExpertCreate:
      type: object
      title: Expert Create
      description: Schema for creating a new expert
      required:
        - name
        - description
        - profession
        - system_message
      properties:
        name:
          type: string
          description: The expert's name
        description:
          type: string
          description: A description of the expert's purpose
        profession:
          type: string
          description: The expert's profession or role
        system_message:
          type: string
          description: System-level instructions
        function_description:
          type: string
          description: Description of the expert's main function
        function_name:
          type: string
          description: Function name identifier
        apps:
          type: array
          description: Connected applications array
        experts:
          type: array
          description: Team member expert IDs array
          items:
            type: integer
        profile_picture:
          type: integer
          description: Media library ID of the profile picture
        expert_llm_models:
          type: array
          description: LLM model configurations
    ErrorResponse:
      type: string
      title: ErrorResponse
      description: Error message returned from the server
  securitySchemes:
    apiKey:
      type: apiKey
      name: bbot-api-key
      in: header
      description: API key for authentication

````