Prompt Architect API Docs

Version: v1 (implicit)

Discovery

• /llms.txt
• /openapi.yaml
• /agents.md
• /agents

Auth

Current mode: none (public beta).

Rate limits

30 requests/minute/IP/endpoint. Exceeding returns 429 and Retry-After.

Endpoints

POST /api/starter-kit

{
  "email": "operator@example.com",
  "name": "optional"
}

POST /api/agent-services

{
  "service_id": "MAC-001",
  "agent_identity": { "name": "ResearchAgent-v2", "framework": "crewai", "version": "0.28.0" },
  "operator_email": "dev@company.com"
}

Idempotency

/api/starter-kit is idempotent by normalized email; duplicates return code=already_exists.

Versioning & deprecation

Current contract is v1 (implicit). Breaking changes are announced in this page and /openapi.yaml.

Webhooks

Not currently implemented.