API Documentation

The FluffyStack REST API gives you programmatic access to the cloud service catalogue, governance policy generation, and list management. Free to use — sign in with GitHub or Google to get an API key.

Base URL

https://api.fluffystack.dev

Quick links

Get an API key

Full API reference

Every endpoint, parameter, response shape, and example.

Read the docs

API Changelog

Version history, breaking changes, new endpoints.

See changelog

JSON Schemas

Machine-readable schemas for export formats.

View schemas

What you can build

Cloud service discovery in CI pipelines

Query GET /v1/services to programmatically check if a service is in the catalogue, what category it belongs to, and its compliance posture.

Generate governance policies on demand

POST an approved service list and get back AWS SCP, Azure Policy, or GCP Org Policy files ready to apply. No client-side code generation needed.

LLM agent tooling

Feed the catalogue to Claude, GPT, or Gemini as context for cloud architecture decisions. The JSON responses are structured and the schema is published.

Save & share service lists

Persist approved service lists via the API and generate shareable URLs for team review.

Authentication

Read-only catalogue endpoints (browse, search, compare, service detail) work without a key. Endpoints that generate exports or create state require a free API key from your account page.

Pass your key via the X-API-Key header on every request.

Rate limits

Tier	Limit
Anonymous (by IP)	30 req/min
Authenticated (by API key)	120 req/min

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Exceeding the limit returns 429 with a Retry-After header.

Quick example

# List all cloud providers (no key required)
curl https://api.fluffystack.dev/v1/providers

# Generate an AWS SCP for your approved services (key required)
curl -X POST https://api.fluffystack.dev/v1/policies/aws-scp \
  -H "X-API-Key: flsk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"serviceIds": ["aws-ec2", "aws-s3", "aws-lambda"]}'

Ready to build?

Get API key