Working API examples

A handful of working API calls for the trial-aware endpoints. The full docs site is in flight — until then this page is the canonical "what can I curl right now?" reference.

1. Validate your trial key

Returns trial metadata + days remaining + dashboard URL. Hit this first to confirm everything is wired.

curl https://api.rt19.runtimeai.io/api/v1/me \
  -H "X-API-Key: YOUR_KEY"

import requests
r = requests.get(
  "https://api.rt19.runtimeai.io/api/v1/me",
  headers={"X-API-Key": "YOUR_KEY"})
print(r.json())

req, _ := http.NewRequest("GET", "https://api.rt19.runtimeai.io/api/v1/me", nil)
req.Header.Set("X-API-Key", "YOUR_KEY")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
io.Copy(os.Stdout, resp.Body)

const r = await fetch("https://api.rt19.runtimeai.io/api/v1/me", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(await r.json());

2. POST any payload — verify your write path

Echoes any JSON back. Useful sanity-check for your client's POST + auth-header flow before you wire a real downstream endpoint.

curl -X POST https://api.rt19.runtimeai.io/api/v1/echo \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hello": "world"}'

3. Trial status (alternate path)

/api/trial/status is the original status endpoint. Same shape as /api/v1/me but returns less metadata. Either works.

curl https://api.rt19.runtimeai.io/api/trial/status \
  -H "X-API-Key: YOUR_KEY"

4. Request a portal-link email (no auth)

If you've lost your API key, hit this with just your email. If a trial exists, you'll get an email with a link back to your portal. Rate-limited to 1 per 30 min.

curl -X POST https://api.rt19.runtimeai.io/api/trial/portal-link \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com"}'

5. Filing a help request from your code

Stuck? POST to this endpoint with what's broken. We get a Slack alert + email follow-up within 1 business day.

curl -X POST https://api.rt19.runtimeai.io/api/trial/help-request \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@company.com",
    "page_url": "https://app.rt19.runtimeai.io/dashboard",
    "description": "Audit log isn'"'"'t showing the agent I just registered. Tenant: my-trial-1."
  }'

Authentication headers

All trial endpoints accept either:

X-API-Key: rtai-trial-...
Authorization: Bearer rtai-trial-...

Pick whichever your HTTP client makes easier. Both validate against the same trial registry.

Errors

401  no auth header
401  key not found in trial registry (typo, never activated, etc.)
410  trial status not active OR trial expired
429  rate-limit exceeded
422  body didn't validate