API Docs

RS Network Web API

This reference covers the current application routes used by the web workspace, treasury, onboarding, approvals, support, and agent surfaces.

AuthenticationThe API now accepts real session tokens for authenticated browser flows. Local development still supports role-scoped headers for protected routes when the dev header-auth gate is enabled.

x-session-token: sess_live_example
Authorization: Bearer sess_live_example

# local development fallback
x-actor-role: advertiser_owner
x-organization-id: org_advertiser_demo

Use x-session-token or Authorization: Bearer for real sessions. x-actor-role and x-organization-id remain development-only.

Core Endpoints

GET/api/v1/health

Liveness probe for the API runtime.

GET/api/v1/ready

Readiness probe for API dependencies and runtime state.

POST/api/v1/auth/sign-in

Email or Telegram sign-in.

GET/api/v1/auth/session

Current session snapshot.

DELETE/api/v1/auth/session

Revoke the current authenticated session.

POST/api/v1/registrations

Partner registration for advertiser or publisher organizations.

GET/api/v1/organizations/:organizationId/memberships

Organization memberships and role data.

GET/api/v1/openclaw/tools/control-summary/:role?organizationId=...

Role-aware control summary for the current cabinet and organization.

GET/api/v1/advertiser/offers/approval-workspace

Advertiser approval workspace for cap and lead review.

POST/api/v1/advertiser/offers/approval-decisions

Approve or reject offer approval items.

GET/api/v1/tracking-links

List tracking links visible to the authenticated actor scope.

PUT/api/v1/tracking-links

Replace the current actor-scoped tracking-link workspace.

GET/api/v1/treasury/payout-approvals

Payout approval queue and reserve posture.

POST/api/v1/treasury/wallet-bindings

Wallet binding receipt for MetaMask or Rabby flows.

POST/api/v1/treasury/google-2fa/enrollment

Begin Google Authenticator-compatible 2FA enrollment.

POST/api/v1/treasury/google-2fa/verify

Verify a TOTP code for treasury-sensitive actions.

POST/api/v1/treasury/withdrawals

Create a withdrawal request requiring manual review.

GET/api/v1/support/cases

Support queue and escalation context.

GET/api/v1/agent-ops/workspace

Agent workspace with OpenClaw-safe controls and policies.

Example Requests

curl -X POST http://127.0.0.1:4000/api/v1/registrations \
  -H "content-type: application/json" \
  --data '{
    "fullName": "Alex Partner",
    "email": "alex@example.com",
    "password": "supersecret123",
    "organizationName": "Orbit Buyers",
    "organizationType": "publisher",
    "verticalFocus": "igaming",
    "trafficSources": ["telegram"],
    "telegramHandle": "@orbitbuyers"
  }'

curl http://127.0.0.1:4000/api/v1/tracking-links \
  -H "x-actor-role: publisher_buyer" \
  -H "x-organization-id: org_publisher_demo"

curl -X PUT http://127.0.0.1:4000/api/v1/tracking-links \
  -H "x-actor-role: publisher_buyer" \
  -H "x-organization-id: org_publisher_demo" \
  -H "content-type: application/json" \
  --data '{"items":[{"id":"link-orbit-001","label":"Nova Casino | DE | Telegram","offerId":"nova-casino","offerLabel":"Nova Casino","advertiser":"Northstar Gaming","country":"DE","vertical":"iGaming","payoutModel":"CPA","payoutValue":"$120 CPA","testCap":"Approved by advertiser","buyerId":"ARB-214","sourceId":"telegram","sourceLabel":"Telegram","campaign":"spring_launch","referrer":"publisher_workspace","metadata":"utm-ready","referralCode":"nova-001","utmSource":"telegram","utmMedium":"affiliate","utmCampaign":"spring_launch","utmTerm":"","utmContent":"creative_a","customParams":"sub_id_1=001","trackingLink":"https://track.affiliate-platform.local/click?link=link-orbit-001","createdAt":"2026-04-08T12:00:00.000Z","clickCount":120,"leadCount":14,"viewCount":640}]}'

curl -X POST http://127.0.0.1:4000/api/v1/treasury/google-2fa/enrollment \
  -H "x-actor-role: publisher_owner" \
  -H "x-organization-id: org_publisher_demo"

curl http://127.0.0.1:4000/api/v1/treasury/payout-approvals \
  -H "x-actor-role: advertiser_owner" \
  -H "x-organization-id: org_advertiser_demo"