Developer Reference
API Documentation
Reference for the Sonu AI deployment webhook and account management endpoints.
Deployment Webhook
This endpoint accepts a signed GitHub push webhook and starts the server-side deployment script configured by DEPLOY_SCRIPT_PATH.
POSThttp://127.0.0.1/sonu_ai/webhooks/github/deploy
Required headers
| Header | Description |
|---|---|
X-GitHub-Event | Use push for deployment. |
X-Hub-Signature-256 | HMAC signature generated with the configured webhook secret. |
Content-Type | application/json. |
Only pushes to the configured deployment branch are accepted. The script path and shell command are never read from the request body.
POST http://127.0.0.1/sonu_ai/webhooks/github/deploy
X-GitHub-Event: push
X-Hub-Signature-256: sha256=<hmac-signature>Account API
Account and API-key management endpoints are served by the Node backend.
| Method | Endpoint | Description |
|---|---|---|
| POST | /auth/register | Create a user account. |
| POST | /auth/login | Authenticate and receive a JWT. |
| GET | /api/v1/keys | List API keys. |
| POST | /api/v1/keys | Create an API key. |
| DELETE | /api/v1/keys/:id | Revoke an API key. |