Events REST reference
Endpoints for listing events and managing subscriptions. TaruviBase fires events itself; there is no endpoint to publish one.
Authentication
Every endpoint requires a credential — see Authentication and authorization. Subscribing, unsubscribing, and listing an app's subscribers also require an organization owner or admin, or another cloud user with access to the site.
List events
| Method | Path | Success | Who can call |
|---|---|---|---|
| GET | /api/cloud/events/ | 200 | Any signed-in caller |
The response's data.events is a list of event names.
Subscribe
| Method | Path | Success | Who can call |
|---|---|---|---|
| POST | /api/cloud/events/{event_name}/subscribe/ | 201 | Cloud access |
Request body:
| Field | Type | Required |
|---|---|---|
function_id | integer | Yes — the id of an existing function |
{event_name} must match an event type
exactly, including case.
The response includes the subscription's id, event, function,
function_name, function_slug, app_name, app_slug, and timestamps.
Unsubscribe
| Method | Path | Success | Who can call |
|---|---|---|---|
| POST | /api/cloud/events/{event_name}/unsubscribe/ | 200 | Cloud access |
Same request body as subscribe. If the function isn't subscribed, the request returns an error — see Troubleshooting.
List an app's subscribers
| Method | Path | Success | Who can call |
|---|---|---|---|
| GET | /api/apps/{app_slug}/events/{event_name}/ | 200 | Cloud access |
| Field | Type | Meaning |
|---|---|---|
event | string | Event name |
app | object | { id, name, slug } |
total_subscribers | integer | Number of this app's subscribed functions |
subscribers | array | One entry per subscribed function |
Each subscriber includes subscriber_id, event, function_id,
function_name, function_slug, filter_conditions, app identifiers, and
created_at.
| Error | Status | Cause |
|---|---|---|
| Unknown app | 404 | No app with that slug |
| Unknown event name | 400 | Not an event type |
| Not allowed | 403 | The caller doesn't have cloud access |