Skip to main content
POST
/
api
/
v1
/
agents
/
{agent_id}
/
tools
Create Agent Tool
curl --request POST \
  --url https://agent-studio.thena.ai/api/v1/agents/{agent_id}/tools \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "configuration": {
    "include_metadata": true,
    "max_results": 10
  },
  "is_enabled": true,
  "tool_name": "knowledge_base_search",
  "tool_type": "built_in"
}'
{
  "agent_id": "123e4567-e89b-12d3-a456-426614174001",
  "configuration": {
    "include_metadata": true,
    "max_results": 10
  },
  "created_at": "2023-01-01T00:00:00Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "is_enabled": true,
  "tool_name": "knowledge_base_search",
  "tool_type": "built_in",
  "updated_at": "2023-01-01T00:00:00Z"
}

Authorizations

x-api-key
string
header
required

Path Parameters

agent_id
string
required

Body

application/json

Model for creating an agent tool configuration.

tool_name
string
required

Name of the tool

tool_type
string
required

Type of tool: 'built_in', 'mcp_server', 'external_tool'

agent_id
string<uuid>
required

ID of the agent

configuration
object | null

Tool-specific configuration settings

is_enabled
boolean
default:true

Whether the tool is enabled

mcp_server_id
string<uuid> | null

ID of the MCP server

external_tool_connection_id
string<uuid> | null

ID of the external tool connection

Response

Successful Response

Model for an agent tool configuration.

tool_name
string
required

Name of the tool

tool_type
string
required

Type of tool: 'built_in', 'mcp_server', 'external_tool'

id
string<uuid>
required

Unique identifier for the agent tool

agent_id
string<uuid>
required

ID of the agent this tool belongs to

created_at
string<date-time>
required

When the tool was configured

updated_at
string<date-time>
required

When the tool was last updated

configuration
object | null

Tool-specific configuration settings

is_enabled
boolean
default:true

Whether the tool is enabled

mcp_server_id
string<uuid> | null

ID of the MCP server (if tool_type is 'mcp_server')

external_tool_connection_id
string<uuid> | null

ID of the external tool connection (if tool_type is 'external_tool')

I