API Collections

Download pre-configured Insomnia and Postman collections. Every RLAAS endpoint, ready to run — just import and go.

Overview

Both collections include every RLAAS API endpoint — decisions, policy CRUD, lifecycle, analytics, and health — with a pre-configured environment so you can start testing immediately.

Endpoints
25+
Environments
Local + Production
Auth
Pre-configured
Formats
Insomnia v4, Postman v2.1
Global variables: Both collections use environment variables for base_url, api_key, org_id, and tenant_id. Change them once and every request updates automatically.

Insomnia Collection

The Insomnia collection uses the v4 export format with workspace-level environment variables and folder grouping.

RLAAS — Insomnia Collection

Insomnia v4 export with environments & folder structure.

Download Insomnia Collection

What's included

  • Workspace environment — base_url, api_key, org_id, tenant_id set globally
  • Decisions folder — POST /v1/check, POST /v1/acquire, POST /v1/release
  • Policies folder — CRUD, validate, rollout, rollback, versions
  • Analytics folder — summary, audit trail
  • Health folder — GET /healthz, GET /readyz

Postman Collection

The Postman collection uses Collection v2.1 format with a companion environment file.

RLAAS — Postman Collection

Postman v2.1 collection + environment file.

Download Collection Download Environment

What's included

  • Collection variables — {{base_url}}, {{api_key}}, {{org_id}}, {{tenant_id}}
  • Pre-request scripts — automatic auth header injection
  • Test scripts — basic assertions on every request (status code, response shape)
  • All endpoint folders — same structure as Insomnia collection

Environment Setup

Both collections ship with two environments. Switch between them to test locally or against production.

VariableLocalProduction
base_urlhttp://localhost:8080https://rlaas.your-company.com
api_keydev-key-change-me(your production key)
org_idacme(your org)
tenant_iddefault(your tenant)
Security: Never commit production API keys to source control. Use Insomnia's encrypted vault or Postman's secret variable type.

Included Endpoints

Every collection covers the full RLAAS API surface:

CategoryMethodEndpointDescription
DecisionsPOST/v1/checkEvaluate a rate-limit decision
POST/v1/acquireAcquire a concurrency lease
POST/v1/releaseRelease a concurrency lease
PoliciesGET/v1/policiesList all policies
GET/v1/policies/:idGet a single policy
POST/v1/policiesCreate a policy
PUT/v1/policies/:idUpdate a policy
DELETE/v1/policies/:idDelete a policy
LifecyclePOST/v1/policies/:id/validateValidate policy config
POST/v1/policies/:id/rolloutUpdate rollout percentage
POST/v1/policies/:id/rollbackRollback to a previous version
AnalyticsGET/v1/analytics/summaryTop policies by traffic
GET/v1/policies/:id/auditAudit trail for a policy
GET/v1/policies/:id/versionsVersion history
HealthGET/healthzLiveness probe
GET/readyzReadiness probe

Import Guide

Insomnia

  1. Open Insomnia → File → Import
  2. Select rlaas-insomnia.json
  3. Choose the Local or Production environment from the top-left dropdown
  4. Update api_key in the environment if needed
  5. Click any request and hit Send

Postman

  1. Open Postman → Import (top-left)
  2. Drag both rlaas-postman-collection.json and rlaas-postman-environment.json
  3. Select the RLAAS Local environment from the top-right environment picker
  4. Update api_key and base_url for your setup
  5. Open any folder, pick a request, and hit Send
Tip: Both collections include example request bodies with realistic payloads. Modify the org_id, user_id, and endpoint fields to match your real services.