API Reference

Integrate ForgeSpacer into your own applications with our REST API. Automate workflows, sync data, and trigger AI document generation programmatically.

Base URL

https://api.ForgeSpacer.dev/v1

Authentication

Authenticate your API requests using a Bearer token. You can generate API keys from your workspace settings. Keep your keys secure and never expose them in client-side code.

curl -X GET https://api.ForgeSpacer.dev/v1/projects \
  -H "Authorization: Bearer fs_live_abc123def456ghi789"

Endpoints

Projects

GET/projects

List all projects in the workspace.

POST/projects

Create a new project.

GET/projects/:id

Retrieve a specific project by ID.

PUT/projects/:id

Update project details.

DELETE/projects/:id

Delete a project permanently.

Documents

GET/projects/:id/documents

List all documents for a project.

POST/projects/:id/documents/generate

Trigger AI generation for a new document.

AI Generation

POST/ai/generate-prd

Generate a comprehensive PRD.

POST/ai/generate-stories

Extract user stories from a document.

POST/ai/generate-sprint-plan

Organize stories into sprints.

Export

POST/projects/:id/export

Export project data to various formats.