Advanced

API Reference

riogentix exposes a REST API for programmatic access to all platform features.

Base URL

https://<tenant>.riogentix.com/api/v1

Authentication

All API requests require a Bearer token:

curl -H "Authorization: Bearer <your-api-token>" \
  https://<tenant>.riogentix.com/api/v1/workflows

Generating an API token:

1. Settings → API Tokens → + New Token
2. Set a name and expiry
3. Copy the token — it won't be shown again

Workflows

List Workflows

GET /workflows

Response:

{
  "data": [
    {
      "id": "wf_abc123",
      "name": "Customer Welcome Email",
      "active": true,
      "createdAt": "2025-01-15T09:00:00Z",
      "updatedAt": "2025-03-01T14:22:00Z"
    }
  ],
  "meta": { "total": 42, "page": 1, "perPage": 20 }
}

Activate a Workflow

PATCH /workflows/:id
Content-Type: application/json

{ "active": true }

Trigger a Workflow via API

POST /workflows/:id/trigger
Content-Type: application/json

{ "data": { "userId": "u_123", "event": "signup" } }

Executions

List Executions

GET /executions?workflowId=wf_abc123&status=success&limit=50

Get Execution Detail

GET /executions/:id

Returns the full execution tree including node-level input/output data.

Rate Limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 248
X-RateLimit-Reset: 1717430400