REST API v1

Build with the
Gravitre API

Programmatically execute AI agents, trigger workflows, and integrate Gravitre into your applications with our RESTful API.

High Performance

Sub-100ms response times with global edge distribution

Secure by Default

OAuth 2.0, API keys, and signed webhooks

Rate Limiting

Generous limits with burst capacity for spikes

Global Infrastructure

Multi-region deployment for low latency

Simple, powerful integration

Execute AI agents with just a few lines of code

example.ts
import { Gravitre } from '@gravitre/sdk';
const client = new Gravitre({
apiKey: process.env.GRAVITRE_API_KEY,
orgId: process.env.GRAVITRE_ORG_ID
});
// Execute a workflow
const run = await client.workflows.execute('wf_lead_sync', {await client.workflows.execute('wf_lead_sync', {
parameters: {
source: 'salesforce',
destination: 'hubspot',
syncMode: 'incremental'
}
});
// Poll for completion or use webhooks
const result = await run.waitForCompletion();await run.waitForCompletion();
console.log(result.status); // 'completed'console.log(result.status); // 'completed'
console.log(result.steps); // Array of step outputsconsole.log(result.steps); // Array of step outputs
// [{ name: 'Fetch Data', status: 'completed', output: {...} }, ...]

API Endpoints

Full reference
POST/api/workflows/{id}/executeCore
GET/api/workflows
GET/api/workflows/{id}/builder
POST/api/workflows/{id}/dry-runCore
GET/api/runs/{id}
POST/api/runs/{id}/approve
GET/api/connectors
POST/api/connectors/{id}/sync
GET/api/metrics/overview
POST/api/operator/action-planAI

Official SDKs

Type-safe clients for your favorite languages

Node.js

npm install @gravitre/sdk
Documentation

Python

pip install gravitre
Documentation

Go

go get github.com/gravitre/go-sdk
Documentation

Webhooks

Receive real-time notifications when runs complete, workflows trigger, or errors occur. All webhooks are signed for security.

Configure webhooks

Authentication

Secure API access with scoped API keys or OAuth 2.0. Fine-grained permissions let you control exactly what each integration can access.

Authentication guide

Rate Limits

Generous limits designed for production workloads

Starter
100 req/min
Burst: 200 req/min
Growth
1,000 req/min
Burst: 2,000 req/min
Enterprise
Custom
Burst: Unlimited

Ready to build?

Get your API key and start integrating Gravitre in minutes.