Developer Quickstart

Choose how you want to work.

CLI, TypeScript SDK, REST API, or Workspace Manager.

CLI

Install the CLI and log in.

List workspaces, inspect resources, make changes, or ask the Concierge from your terminal.

@gravity-rail/cli on npm ↗
CLI quickstart
$ npm install -g @gravity-rail/cli
$ gr login --env prod
$ gr whoami
$ gr workspaces list
$ gr concierge chat --allow-write
TypeScript SDK

Use Gravity Rail from Node or TypeScript.

Create a client with an API key, then call the workspace methods you need.

SDK reference ↗
TypeScript SDK
npm install @gravity-rail/sdk

import { GravityRailClient } from '@gravity-rail/sdk';

const client = new GravityRailClient(
  process.env.GRAVITY_RAIL_API_KEY,
  'https://api.gravityrail.com'
);

const workspaces = await client.getWorkspaces();
REST API

Call the API from any language.

Start by listing the workspaces available to your API key. Workspace routes use the workspace UUID in the path.

API reference ↗
REST API
curl https://api.gravityrail.com/api/v2/w \
  -H "Authorization: Bearer $GRAVITY_RAIL_API_KEY" \
  -H "Content-Type: application/json"

curl https://api.gravityrail.com/api/v2/w/$WORKSPACE_ID/agents \
  -H "Authorization: Bearer $GRAVITY_RAIL_API_KEY"
Workspace Manager

Describe what you need in chat.

Ask the Manager to create or change a Workflow, then review the Tasks, permissions, and escalation rules before testing.

Create a workspace →
Build a patient enrollment Workflow. Check eligibility, answer from our approved documents, and send coverage questions to a coordinator.
Workspace ManagerCreated the Patient Enrollment Workflow.Added Tasks for eligibility, questions, and coordinator handoff.Ready for you to review and test.

Read the full developer documentation.