REST API · v1 · Agency plan

Prism Cloud AI REST API

Generate engineering-grade specifications programmatically. The API mirrors the four pipeline stages of the product — Constitution, Specification, Architecture and Tasks — and returns the same artifacts you see in the dashboard, as structured JSON or Markdown.

Bearer authentication

Workspace-scoped tokens with granular scopes.

Predictable limits

60 req/min on Pro, 600 req/min on Agency, burst-friendly.

Webhooks

Signed HMAC payloads for pipeline.completed and credit.exhausted.

Authentication

All requests must include a bearer token issued from the dashboard. Tokens inherit the credits and plan of the issuing workspace.

curl https://api.prismcloud.app/v1/pipelines \
  -H "Authorization: Bearer $PRISMCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idea": "A subscription billing dashboard for SaaS finance teams",
    "stack_hints": ["Next.js", "Postgres", "Stripe"],
    "stages": ["constitution", "specification", "architecture", "tasks"]
  }'

Endpoints

Method	Path	Description
POST	/v1/pipelines	Run the full 4-stage pipeline for an idea.
GET	/v1/pipelines/:id	Retrieve a pipeline run and its generated artifacts.
GET	/v1/projects	List projects in your workspace.
POST	/v1/projects/:id/exports	Export a project to PDF, Markdown or JSON.
GET	/v1/credits	Inspect remaining credits and renewal date.
POST	/v1/webhooks	Subscribe to pipeline.completed and credit.exhausted events.

Response shape

Every pipeline run returns four artifact blocks with stable JSON keys you can render or pipe into a downstream workflow.

Security

TLS 1.3, signed webhooks, IP allowlists on Agency plans, and zero-retention upstream model routing.

Request API access

The REST API is available on the Agency plan. Tokens are provisioned within one business day of contract signature.

Talk to sales