GETTING STARTED

Introduction

Installation

Quickstart

Token Issuance

All API access is governed by OAuth 2.0 client credentials flow over mTLS-terminated connections. A POST request to /v1/auth/token returns a signed JWT bearing the tenant’s permission scope, region affinity, and a 15-minute expiry window. Tokens are issued by Meridian’s distributed credential authority, which replicates across three availability zones to eliminate single-point-of-failure exposure during peak issuance load.

Scoping & Permissions

Each token payload encodes a permission set derived from the role assigned to the service principal at provisioning time. Granular scopes — such as inference:read, pipeline:write, and telemetry:export — are evaluated at the edge before any request reaches the data plane. Attempts to invoke endpoints outside a token’s declared scope return a 403 SCOPE_VIOLATION with a structured error body detailing the missing permission.

Token Rotation & Revocation

Meridian enforces automatic rotation for all production credentials on a 30-day cycle, triggered server-side without requiring client-side intervention. Revocation propagates to all edge nodes within 250 milliseconds via an event-sourced invalidation bus. Emergency revocation endpoints allow security teams to invalidate a compromised credential globally in a single API call, with full audit trail written to the immutable compliance log.

shell
1
curl -X POST https://api.meridian.dev/v1/auth/token \
2
-H "Content-Type: application/json" \
3
-d '{"client_id": "cid_prod_8f3a2", "client_secret": "cs_live_Xk92...", "grant_type": "client_credentials"}'

GETTING STARTED

Introduction

Installation

Quickstart

ON THIS PAGE

Token Issuance

Scoping & Permissions

Token Rotation & Revocation

DEPLOY / MERIDIAN

Start building with Meridian.

Two ways in — pick your path.

01

For humans

Get started with our Next.js and Python SDKs in seconds.

02

For agents

Tools to connect your autonomous agents to our edge infrastructure.

$npm install @synapse/sdk

Aquire $129

Aquire $129

Aquire $129

Create a free website with Framer, the website builder loved by startups, designers and agencies.