API Reference

REST endpoints for SteamForge AI. All authenticated routes require a valid Clerk session.

Full reference available in docs/API.md in the repository.

Health

GET/api/health

Service health check

Auth & Users

GET/api/users/me

Current user profile, plan, subscription, and usage

Projects

GET/api/projects

List user projects (paginated)

POST/api/projects

Create a new project

GET/api/projects/:id

Get project with generations and assets

PATCH/api/projects/:id

Update project details

DELETE/api/projects/:id

Archive a project

Generations

GET/api/generations

List generations (paginated)

POST/api/generations

Start a new asset generation

GET/api/generations/:id

Get generation with assets

DELETE/api/generations/:id

Delete a generation

Templates

GET/api/templates

Browse approved templates

POST/api/templates/:id/favorite

Favorite a template

DELETE/api/templates/:id/favorite

Remove favorite

Billing

POST/api/billing/checkout

Create Stripe checkout session

GET/api/billing/checkout

Open Stripe billing portal

POST/api/webhooks/stripe

Stripe webhook handler

Uploads

POST/api/uploads/presign

Get presigned R2 upload URL

Downloads

POST/api/downloads

Request asset download manifest / ZIP

Admin

GET/api/admin/stats

Dashboard statistics

PATCH/api/admin/stats

Update feature flags

GET/api/admin/users

List users (paginated)

PATCH/api/admin/users

Update user role, plan, credits

Response format

// Success
{ "success": true, "data": { ... } }

// Error
{ "success": false, "error": "Message", "details": { ... } }