Getting started with the SiteGPT API

The SiteGPT API allows you to programmatically manage chatbots, send messages, access conversation history, and configure settings. All endpoints use REST principles and return JSON responses.

This page documents the legacy /api/v0 API. For new integrations, use API Reference → v2 from the version selector.

Base URL

All API requests are made to:

https://sitegpt.ai/api/v0

Authentication

SiteGPT uses API keys for authentication. Include your API key in the Authorization header of every request.

This is the legacy v0 API. New integrations should use the v2 Agent API with scoped sgpt_ tokens from the Agents page.

Getting your API key

Sign in to your SiteGPT account
Open Billing in the top navigation; your API key is shown there when your plan includes API access
Copy your API key
Store it securely (never commit to version control)

Keep your API key secure. Anyone with your key can access and modify your chatbots.

Using your API key

Include your API key in the Authorization header with the Bearer scheme:

Authorization: Bearer YOUR_API_KEY

Example request

curl https://sitegpt.ai/api/v0/chatbots \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://sitegpt.ai/api/v0/chatbots', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://sitegpt.ai/api/v0/chatbots',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()

Authentication errors

If your API key is missing, malformed, or invalid, you’ll receive a 401 Unauthorized response:

{
  "success": false,
  "message": "Failed to authenticate",
  "data": null,
  "error": {
    "code": "API_KEY_NOT_VALID",
    "message": "Authorization header does not contain valid API key",
    "details": null
  }
}

Response format

All API responses use a consistent JSON structure:

Success response

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    // Response data here
  }
}

Error response

{
  "success": false,
  "message": "Operation failed",
  "data": null,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": null // or array of validation errors
  }
}

Error handling

HTTP status codes

200 OK - Request succeeded
400 Bad Request - Invalid request parameters or body
401 Unauthorized - Missing or invalid API key
403 Forbidden - Insufficient permissions
404 Not Found - Resource doesn’t exist
405 Method Not Allowed - HTTP method not supported
500 Internal Server Error - Server error

Common error codes

API_KEY_NOT_VALID - Invalid or missing API key
REQUEST_VALIDATION_FAILED - Request body validation failed
CHATBOT_NOT_FOUND - Chatbot doesn’t exist
CHATBOT_FETCH_FORBIDDEN - No permission to access chatbot
CHATBOT_LIMIT_REACHED - Exceeded chatbot quota
MESSAGES_LIMIT_REACHED - Exceeded message quota

Validation errors

When request validation fails, the error.details array contains specific field errors:

{
  "success": false,
  "message": "Failed to create chatbot",
  "data": null,
  "error": {
    "code": "REQUEST_VALIDATION_FAILED",
    "message": "Request body is not valid",
    "details": [
      {
        "path": ["chatbotName"],
        "message": "Required"
      }
    ]
  }
}

Rate limiting

API requests are rate-limited to keep the platform stable. Limits depend on your plan; when you exceed them you receive a 429 Too Many Requests response. Back off and retry with exponential delays.

Pagination

List endpoints support pagination using query parameters:

GET /v0/chatbots?page=1&limit=20

Parameters:

page - Page number (default: 1)
limit - Results per page (default: 20, max: 100)

Paginated responses include metadata:

{
  "success": true,
  "message": "Fetched chatbots successfully",
  "data": {
    "chatbots": [...],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 45,
      "pages": 3
    }
  }
}

Making requests

curl -X POST https://sitegpt.ai/api/v0/chatbots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chatbotName": "My New Chatbot"
  }'

const response = await fetch('https://sitegpt.ai/api/v0/chatbots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    chatbotName: 'My New Chatbot'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://sitegpt.ai/api/v0/chatbots',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'chatbotName': 'My New Chatbot'
    }
)

data = response.json()

<?php
$ch = curl_init('https://sitegpt.ai/api/v0/chatbots');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'chatbotName' => 'My New Chatbot'
]));

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);
?>

Common workflows

Creating and configuring a chatbot

Create chatbot

POST /v0/chatbots

Update appearance

PATCH /v0/chatbots/{chatbotId}/appearance

Add training content

POST /v0/chatbots/{chatbotId}/links

Configure settings

PATCH /v0/chatbots/{chatbotId}/settings/general

Add conversation starters

POST /v0/chatbots/{chatbotId}/quick-prompts

Sending messages

Create thread

POST /v0/chatbots/{chatbotId}/threads

Send message

POST /v0/chatbots/{chatbotId}/message

Fetch response

Included in send message response

Update reaction

PATCH /v0/chatbots/{chatbotId}/messages/{messageId}

Managing conversations

Fetch all threads

GET /v0/chatbots/{chatbotId}/threads

Get thread details

GET /v0/chatbots/{chatbotId}/threads/{threadId}

Escalate to agent

POST /v0/chatbots/{chatbotId}/threads/{threadId}/escalate

Update thread

PATCH /v0/chatbots/{chatbotId}/threads/{threadId}

API resources

The SiteGPT API provides endpoints for:

Chatbots - Create, read, update, delete chatbots
Appearance - Customize chatbot visual design
Content - Manage training data and custom responses
Messages - Send and receive messages
Threads - Manage conversation threads
Settings - Configure chatbot behavior
Prompts - Manage instructions and personas
Quick Prompts - Conversation starters
Follow-up Prompts - Post-response suggestions
Icons - Upload custom icons
Whitelabel - Manage white-label brands and users (enterprise)

Best practices

Security
Performance
Error handling
Data management

Never expose API keys - Keep them server-side only

Use environment variables - Don’t hardcode keys

Rotate keys regularly - Generate new keys periodically

Limit key scope - Use separate keys for different environments

Check success field - Always verify success: true

Log error codes - Track error patterns

Retry transient errors - Retry 500 errors with backoff

Validate before sending - Reduce 400 errors

Webhooks

Instead of polling the API, use webhooks to receive real-time updates:

New messages
Lead captures
Conversation escalations
Custom events

Configure webhooks in your chatbot settings or via the API. See Chatbot Settings - Advanced for webhook configuration.

SDKs and libraries

Official SDKs

Currently, SiteGPT doesn’t provide official SDKs. Use standard HTTP libraries in your language of choice.

Community libraries

Check our community forum for user-contributed libraries and wrappers.

Support

Need help with the API?

Documentation - Browse the API reference
Email - support@sitegpt.ai
Community - Join our Slack or forum
Enterprise - Dedicated support for enterprise customers

Next steps

Chatbot endpoints

Create and manage chatbots programmatically

Messages

Send messages and handle conversations

Settings

Configure chatbot behavior via API

Threads

Manage conversation threads

​Base URL

​Authentication

​Getting your API key

​Using your API key

​Example request

​Authentication errors

​Response format

​Success response

​Error response

​Error handling

​Validation errors

​Rate limiting

​Pagination

​Making requests

​Common workflows

​API resources

​Best practices

​Webhooks

​SDKs and libraries

​Official SDKs

​Community libraries

​Support

​Next steps

Chatbot endpoints

Messages

Settings

Threads

Base URL

Authentication

Getting your API key

Using your API key

Example request

Authentication errors

Response format

Success response

Error response

Error handling

Validation errors

Rate limiting

Pagination

Making requests

Common workflows

API resources

Best practices

Webhooks

SDKs and libraries

Official SDKs

Community libraries

Support

Next steps