Skip to main content
POST
/
api
/
mcp
/
tool-groups
Error
A valid request URL is required to generate request examples
{
  "mcp_tool_group": {
    "id": 123,
    "name": "<string>",
    "description": "<string>",
    "enabled": true,
    "tools": [
      {
        "mcp_client_id": "<string>",
        "tool_names": [
          "<string>"
        ]
      }
    ],
    "virtual_key_ids": [
      "<string>"
    ],
    "team_ids": [
      "<string>"
    ],
    "customer_ids": [
      "<string>"
    ],
    "user_ids": [
      "<string>"
    ],
    "provider_names": [
      "<string>"
    ],
    "api_key_ids": [
      123
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}
{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"model_requested": "<string>",
"request_type": "<string>"
}
}

Authorizations

Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Body

application/json
name
string
required
Maximum string length: 255
tools
object[]
required
description
string
enabled
boolean

If omitted, the group is created with enabled: false. Send true explicitly to activate the group on creation.

virtual_key_ids
string[]
team_ids
string[]
customer_ids
string[]
user_ids
string[]
provider_names
string[]
api_key_ids
integer<uint>[]

Response

Group created

mcp_tool_group
object