REST API

Introduction

The Carbon API is a REST interface over your manufacturing data — every table and view is an endpoint, with full read and write access.

There are three ways to call it: directly over HTTP, through the JavaScript SDK, or from the MCP server. Start by creating an API key.

Client libraries

Carbon's API is standard REST, so it works from any language. The recommended client is the JavaScript SDK, built on supabase-js.

JavaScript & TypeScript

The recommended client — supabase-js. Read and write Carbon with carbon.from('…').

Quickstart

Dart & Flutter

The official supabase-flutter SDK for Dart and Flutter apps.

Supabase Dart

Swift

The official supabase-swift SDK for iOS, macOS, and server-side Swift.

Supabase Swift

Python

The official supabase-py client, or call the REST API directly with requests.

Supabase Python

Quickstart

Save your key and the API URL as environment variables:

.env

# .env
CARBON_API_URL=https://rest.carbon.ms
CARBON_API_KEY=<your-api-key>

Then initialize the client:

lib/carbon.ts

import { createClient } from '@supabase/supabase-js'

const apiUrl = process.env.CARBON_API_URL
const apiKey = process.env.CARBON_API_KEY

export const carbon = createClient(apiUrl, apiKey)

You can now query any resource with carbon.from('…'). Pick a resource from the sidebar for its endpoints and ready-to-copy samples — pointed at your configured instance.