Create a Chat

Guide to creating a Chat in the Fetch Hive API.

Create a new chat

post

Create a new chat for an agent

Authorizations

bearerAuth

AuthorizationstringRequired

Enter the token with the Bearer: prefix, e.g. "Bearer abcde12345".

Path parameters

agent_idstringRequired

Agent token

Body

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

Responses

200

Successful response

application/json

default

Error

application/json

post

/agents/{agent_id}/chats

HTTPcURLJavaScriptPython

POST /v1/agents/{agent_id}/chats HTTP/1.1
Host: api.fetchhive.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "chat": {
    "name": "text"
  }
}

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

{
  "message": "Successfully created a chat.",
  "chat": {
    "id": 1,
    "name": "text",
    "last_message_content": "text",
    "last_message_sent_at": "2026-01-30T00:16:00.699Z",
    "message_count": 1,
    "generated_at": "2026-01-30T00:16:00.699Z",
    "token": "text",
    "status": "text",
    "agent": {
      "token": "text"
    }
  }
}