Create an Agent

Guide to creating an Agent in the Fetch Hive API.

Create a new agent

post

Create a new agent with specified parameters

Authorizations

bearerAuth

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Responses

200

Successful response

application/json

default

Error

application/json

post

HTTPcURLJavaScriptPython

POST /v1/agents HTTP/1.1
Host: api.fetchhive.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 249

{
  "agent": {
    "name": "text",
    "description": "text",
    "model_type": "text",
    "llm_model": "text",
    "temperature": 1,
    "max_token": 1,
    "max_thinking_token": 1,
    "instruction_prompt": "text",
    "google_search_tool": "disabled",
    "history_tool": "disabled",
    "reasoning_effort": "low"
  }
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "message": "Successfully created an agent.",
  "agent": {
    "id": 1,
    "name": "text",
    "token": "text",
    "custom_model": "text",
    "llm_model": "text",
    "temperature": 1,
    "reasoning_effort": "low",
    "max_token": 1,
    "max_thinking_token": 1,
    "instruction_prompt": "text",
    "model_type": "text",
    "provider": "text",
    "google_search_tool": "text",
    "history_tool": "text",
    "status": "text",
    "mcp_tools": [
      {
        "id": 1,
        "token": "text",
        "generated_at": "2025-09-18T06:09:00.639Z",
        "status": "text",
        "mcp_type": "google_search",
        "is_enabled": true,
        "is_disabled": true,
        "data_set": {
          "id": 1,
          "name": "text",
          "token": "text",
          "namespace": "text",
          "search_type": "text",
          "search_score_threshold": 1,
          "search_chunk_limit": 1
        }
      }
    ]
  }
}