Developer Guides

Welcome to the Gravity Rail developer guides! These focused guides walk you through key aspects of working with Gravity Rail:

Getting Started

• Getting Started with Integration - Complete onboarding guide from member registration to webhooks and MCP
• Authentication - OAuth 2.0 and API key setup
• CLI Getting Started - Install the gr CLI and drive your workspace from the terminal — or hand it to your coding agent
• TypeScript SDK Getting Started - Create a typed client and make your first calls from Node or the browser
• Error Handling - Standard API error response format, status codes, and PHI-safe error design
• Claude Skills for Gravity Rail - Install the Gravity Rail plugin for Claude Code and Cowork

Core Data Management

• Understanding Data - Understanding data types, fields, records, and the permissions system
• Importing Data - How to populate Gravity Rail with data via APIs and UIs
• Exporting Data - How to extract data from Gravity Rail and subscribe to real-time updates via webhooks

User & Account Management

• Importing Members - How to create and manage users in your workspace

Trust, Safety & Compliance

• Using Gravity Rail with PHI - Contractual and configuration requirements that apply before sending PHI
• AI Disclosure Requirements - Disclosing AI usage to end users

Next Steps

New to Gravity Rail? Start with Getting Started with Integration for a complete walkthrough of the essential integration steps.

For detailed topics, each guide builds on core concepts. Understanding Data in Gravity Rail explains the data model, while import/export guides show you how to move data in and out.

For the complete API reference, see API Reference.