Skip to main content
PUT
/
v1
/
experts
/
{expert_id}
Update Expert (PUT)
curl --request PUT \
  --url https://api.b-bot.space/api/v2/v1/experts/{expert_id} \
  --header 'Content-Type: application/json' \
  --header 'bbot-api-key: <api-key>' \
  --header 'bbot_api_key: <bbot_api_key>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "profession": "<string>",
  "system_message": "<string>",
  "function_description": "<string>",
  "function_name": "<string>",
  "apps": "<array>",
  "profile_picture": 123,
  "abilities": "<array>",
  "templates": "<array>",
  "experts": [
    123
  ],
  "expert_llm_models": "<array>",
  "task_assistant_id": "<string>"
}
'
{
  "id": "<string>",
  "attributes": {}
}
Permission Required: This endpoint is only available for Agencies and Middleware Partners.

​
Partial Updates Supported

Both PUT and PATCH methods support partial updates. You only need to include the fields you want to change. The API automatically validates ownership - you can only update experts you own.

Authorizations

​
bbot-api-key
string
header
required

API key for authentication

Headers

​
bbot_api_key
string
required

API Key for authentication

Path Parameters

​
expert_id
string
required

The unique identifier of the expert to update

Body

application/json

Schema for updating an existing expert (all fields optional)

​
name
string

Update the expert's name

​
description
string

Update the expert's description

​
profession
string

Update the expert's profession

​
system_message
string

Update the system instructions

​
function_description
string

Update the function description

​
function_name
string

Update the function name

​
apps
array

Update the connected applications

​
profile_picture
integer

Update the profile picture

​
abilities
array

Update the abilities array

​
templates
array

Update the templates array

​
experts
integer[]

Update team member expert IDs

​
expert_llm_models
array

Update LLM model configurations

​
task_assistant_id
string

Link a task assistant ID

Response

Success

​
id
string

Updated expert ID

​
attributes
object

Updated expert attributes