Authentication

https://api.cerulea.app/v1

Cerulea uses a dual authentication system, API keys for server-to-server communication and OAuth 2.0 for user-facing applications and third-party integrations.

API Key Authentication

For server-to-server communication and automated workflows.

POST /auth/api-keys

Create a new API key with custom scopes and expiration

Include your API key in every request header:

BASH

curl https://api.cerulea.app/v1/workspaces \
  -H "X-API-Key: ck_live_your_api_key_here" \
  -H "Content-Type: application/json"

OAuth 2.0

For user-facing applications and third-party integrations.

BASH

curl -X POST https://api.cerulea.app/oauth/token \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "redirect_uri=https://yourapp.com/callback"

Available Scopes

Scope	Description
workspace:read	Read workspace data
workspace:write	Create and modify workspaces
blockchain:read	Query blockchain data
blockchain:write	Deploy and manage blockchains
blockchain:deploy	Deploy smart contracts
validator:read	View validators
validator:write	Manage validators
governance:read	View governance proposals
governance:write	Create and vote on proposals
admin	Full administrative access