API Reference

Build custom integrations or automate your workflow with the SuuSri REST API. Our interface follows a predictable, resource-oriented design.

Authentication

The SuuSri API uses API keys to authenticate requests. You can view and manage your API keys in the Developer Hub.

Authorization Header
curl -X GET https://api.suusri.app/v1/sites \ 
  -H "Authorization: Bearer YOUR_API_KEY"

Core Endpoints

GET/v1/sites
Developer Scoped

Retrieve a list of all verified sites associated with your API key.

POST/v1/chat/message
Bot Scoped

Send a message to an AI instance belonging to a specific site.

GET/v1/analytics/leads
Sales Scoped

Fetch captured lead data for CRM integration.

Error Codes

401_UNAUTHORIZED

API key is missing or invalid.

403_DOMAIN_MISMATCH

The request originated from a domain not verified for this key.

429_RATE_LIMIT

You have exceeded your plan's request limit.

503_ENGINE_BUSY

The AI engine is currently under high load. Retry with exponential backoff.

SuuSri Discovery Protocol (SDP)

SuuSri endpoints are compatible with the SuuSri Discovery Protocol (SDP). This allows third-party AI agents to programmatically query your site's capabilities by resolving your verified suusri.json file.

Rate Limit
5k/min
Uptime
99.99%
SLA
Premium
Global
24 Regions