Make your first API calls

• A SiteGPT account with at least one chatbot that has content. API v2 needs the Growth plan or above, on your own account or on the account that owns the chatbot. See Which plan applies.
• A terminal with curl.

Step 1: Create an API token

1. Sign in to SiteGPT.
2. In the top navigation, select Agents.
3. In Create API token, enter the Token name First API calls.
4. Keep the default Expires value and the Standard access level.
5. Keep All accessible chatbots.
6. Select Create token.
7. Copy the token. It starts with sgpt_. SiteGPT shows it only once.

export SITEGPT_API_TOKEN="YOUR_API_TOKEN"

curl https://sitegpt.ai/api/v2/me \
  -H "Authorization: Bearer $SITEGPT_API_TOKEN"

Step 2: List your chatbots

curl https://sitegpt.ai/api/v2/chatbots \
  -H "Authorization: Bearer $SITEGPT_API_TOKEN"

{
  "ok": true,
  "data": {
    "chatbots": [
      { "id": "YOUR_CHATBOT_ID", "title": "Support Bot", "...": "..." }
    ]
  },
  "meta": { "requestId": "..." }
}

export SITEGPT_CHATBOT_ID="YOUR_CHATBOT_ID"

Step 3: Send a message

curl -X POST "https://sitegpt.ai/api/v2/chatbots/$SITEGPT_CHATBOT_ID/messages" \
  -H "Authorization: Bearer $SITEGPT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "What are your opening hours?" }'

• data.conversation.threadId is the ID of the new conversation.
• data.message.answer.text is the chatbot’s answer.

{
  "ok": true,
  "data": {
    "conversation": { "threadId": "YOUR_CONVERSATION_ID", "...": "..." },
    "message": {
      "messageType": "NORMAL_MESSAGE",
      "question": { "text": "What are your opening hours?", "...": "..." },
      "answer": { "text": "...", "...": "..." },
      "sources": ["..."]
    }
  },
  "meta": { "requestId": "..." }
}

export SITEGPT_THREAD_ID="YOUR_CONVERSATION_ID"

Step 4: Read the conversation

curl "https://sitegpt.ai/api/v2/chatbots/$SITEGPT_CHATBOT_ID/conversations/$SITEGPT_THREAD_ID" \
  -H "Authorization: Bearer $SITEGPT_API_TOKEN"

What you did

• The base URL is https://sitegpt.ai/api/v2.
• The token goes in the Authorization: Bearer header.
• The response is { "ok": true, "data": ..., "meta": ... }, or { "ok": false, "error": ... } when something fails.

Next steps

• API conventions: pagination, errors, and deletes.
• Authentication: access levels, scopes, and device login.
• TypeScript SDK and Python SDK: the same calls from code.
• The endpoint pages in this API reference list every operation, with its scopes and fields. The OpenAPI document is at https://sitegpt.ai/api/v2/openapi.json.
• Moving from the legacy API? See Move from API v0 to v2.