·Back to demos
Sessioninitializing…
Watch this session →

API reference

GraphQL + REST. Pick the one you like.

Both APIs are first-class — same auth, same rate limits, same SLAs. GraphQL is recommended for new builds; REST is great for shell + webhook integrations.

Auth

Personal access tokens (PATs) via Settings → API. OAuth 2.0 for third-party apps via /oauth/authorize.

curl https://api.relyvflow.demo/v1/workspaces \
  -H "Authorization: Bearer pat_xxx"

Rate limits

5,000 req/min per workspace, soft. We return 429 with Retry-After. Enterprise plans get 25,000 req/min.

Endpoints

POST/graphql

Single endpoint, full schema introspection. Recommended for new integrations.

GET/v1/workspaces

List all workspaces accessible to the API key.

GET/v1/workspaces/{w}/issues

Paginated list of issues. Filter by state, label, assignee, cycle, project.

POST/v1/workspaces/{w}/issues

Create issue. Idempotent via Idempotency-Key header.

PATCH/v1/issues/{id}

Partial update — only fields you send are mutated.

POST/v1/webhooks

Register a webhook. We send signed POSTs on every issue + project event.

GET/v1/audit-log

Audit log stream. Cursor-paginated, retained 365 days.