Authentication

Every request to the Project Integration APIs requires an API Key in the api-key header. You generate this key from your project's integration settings.

Generating your API Key

1. Go to your project's Integrations page and click Manage on API Integration

2. Click Generate API Key to create a new key

3. Copy your generated API key

Using your API Key

Pass the key in the api-key header on every request:

curl -X POST https://api.yourgpt.ai/chatbot/v1/createSession \
  -H "api-key: apk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"widget_uid": "your-widget-uid"}'

All API keys use the apk- prefix:

apk-ca1b2c3d4e5f...

Response format

All endpoints return a consistent JSON structure:

• Success: HTTP 200 with "type": "RXSUCCESS"
• Error: HTTP 400 with "type": "RXERROR"

Error codes