Chat

Chat with Cuppa AI research agent

Chat with Cuppa AI agent

post

Send messages to Cuppa AI agent with access to research tools. The agent can research keywords, analyze competitors, check SERP data, and provide content strategy insights. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidOptional

Site ID for brand context. If not provided, uses first active site.

modelstringOptional

The model to use for chat

Default: gpt-5-mini

max_tokensinteger · min: 100 · max: 16000OptionalDefault: 4000

Responses

200

Chat completion response

application/json

post

/v1/chat/completions

HTTPcURLJavaScriptPython

POST /v1/chat/completions HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 165

{
  "messages": [
    {
      "role": "user",
      "content": "text"
    }
  ],
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "model": "gpt-5-mini",
  "tools": [
    "research_keywords"
  ],
  "max_tokens": 4000
}

200

Chat completion response

{
  "message": {
    "role": "assistant",
    "content": "text"
  },
  "tool_calls": [
    {
      "tool": "text",
      "input": {},
      "output": {},
      "success": true
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1
  },
  "model": "text"
}