Rogatus
ArchitectureEnter app
API reference · v1.0

A small, friendly API

JSON in, JSON out. Bearer-token auth. Stable since 2025. Every endpoint below is wired and battle-tested in production.

Quick reference
POST/v1/auth/sessionGET/v1/questionsPOST/v1/questionsPOST/v1/questions/:id/sendGET/v1/responsesPOST/v1/reports/generatePOST/v1/roomsGET/v1/admin/moderation/queue
Authentication

Every request needs a bearer token:

Authorization: Bearer rg_live_•••••••••••
POST
/v1/auth/session

Create a session for a role-based identity.

{ "role": "user" }
GET
/v1/questions

List questions with filters and pagination.

?category=c1&status=active&page=1
POST
/v1/questions

Create a custom question.

{ "text": "...", "categoryId": "c2" }
POST
/v1/questions/:id/send

Send a question via link / email / SMS.

{ "channel": "email", "recipients": ["a@x.com"] }
GET
/v1/responses

Fetch responses for a question.

?questionId=q1
POST
/v1/reports/generate

Generate an AI report from collected responses.

{ "questionId": "q1" }
POST
/v1/rooms

Open a group room.

{ "name": "Sunday Soulchat", "questionId": "q2" }
GET
/v1/admin/moderation/queue

List flagged content awaiting review.

?severity=high
Rate limits & errors

1000 req/min
per token. Bursts of 50/sec allowed.

Errors follow { "error": { "code": "rate_limited", "message": "..." } }