> ## 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 Template Experts

> Retrieve publicly available expert templates for installation. Only available for Agencies and Middleware Partners.

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

## Template Categories

Available categories for filtering:

* `Sales & Marketing`
* `Customer Support`
* `Development`
* `Finance & Accounting`
* `HR & Recruitment`
* `Content Creation`
* `Project Management`
* `Data Analysis`
* `Education`
* `Other`

## Featured Templates

Featured templates have been reviewed and approved by B-Bot administrators. They represent high-quality, well-tested configurations suitable for production use.

## Template Installation

When installing a template expert:

1. **Copy configuration** - Expert settings are duplicated to user's account
2. **Remove credentials** - App credentials are NOT copied
3. **Prompt for apps** - User must connect their own app credentials
4. **Copy knowledge** - Knowledge containers are duplicated
5. **Increment counter** - `template_usage_count` is incremented
6. **Create expert** - New expert is created under user's ownership


## OpenAPI

````yaml get /v1/get_template_experts
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_template_experts:
    get:
      tags:
        - Experts
      summary: Get Template Experts
      description: >-
        Retrieve publicly available expert templates for installation. Only
        available for Agencies and Middleware Partners.
      operationId: get_template_experts_v1_get_template_experts_get
      parameters:
        - name: bbot_api_key
          in: header
          required: true
          schema:
            type: string
            title: B-Bot API Key
            description: API Key for authentication
        - name: category
          in: query
          required: false
          schema:
            type: string
            title: Category
            description: >-
              Filter templates by category (e.g., "Sales & Marketing", "Customer
              Support")
        - name: featured
          in: query
          required: false
          schema:
            type: boolean
            title: Featured
            description: Filter to show only featured templates
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  templates:
                    type: array
                    items:
                      $ref: '#/components/schemas/TemplateExpert'
        '403':
          description: Invalid API key or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No templates found matching the criteria
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TemplateExpert:
      type: object
      title: Template Expert
      description: Expert configured as a public template
      allOf:
        - $ref: '#/components/schemas/ExpertDetailed'
        - type: object
          properties:
            attributes:
              type: object
              properties:
                template_category:
                  type: string
                  description: Template category
                template_featured:
                  type: boolean
                  description: Featured status
                template_usage_count:
                  type: integer
                  description: Number of times installed
    ErrorResponse:
      type: string
      title: ErrorResponse
      description: Error message returned from the server
    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
    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

````