Documentation Reference

API reference

Everything the console and the CLI do goes through this HTTP API. 2004 operations, grouped by what they manage.

Basics

Base URL

https://api.gregale.dev. Every path below starts with /v1.

Authentication

Send an API key as Authorization: Bearer <key>. Create one in the console under Settings → API keys. The CLI reads it from FAAS_TOKEN.

Errors

Failures are application/problem+json with a stable code to branch on. Error codes

Retries

Operations that list an Idempotency-Key header store the response for 24 hours; a retry with the same key gets it back instead of acting twice.

By area

Generating a client? The machine-readable spec is at /v1/openapi.yaml.