Endpoint
POST /api/solution-brief drafts a technology solution brief in Markdown for the goals you describe. The response is streamed as newline-delimited JSON.
- Request body (JSON): goals (string, 20 to 4000 characters, required), industry (string, up to 120 characters, optional), stage (string, up to 80 characters, optional).
- Stream events: {"type":"delta","text":"..."} chunks, then {"type":"done"}. On failure: {"type":"error","message":"..."}.
- Status codes: 400 for input that does not match the schema, 429 when the AI service is busy, 503 when the brief generator is unavailable.
Quickstart
Request a draft brief from the command line:
curl -N -X POST https://juhenza.com/api/solution-brief \
-H 'Content-Type: application/json' \
-d '{"goals":"We need a customer portal to track project progress and share documents.","industry":"Professional services","stage":"Early"}'Machine-readable descriptions
- OpenAPI 3.1 description: /openapi.json
- API catalog (RFC 9727 linkset): /.well-known/api-catalog
- Agent skills index: /.well-known/agent-skills/index.json
- Site overview for agents: /llms.txt and /index.md
Authentication, limits and sandbox
The endpoint does not require authentication, so do not send credentials to it. Usage limits are not published yet. Keep automated traffic modest and expect 429 responses under load.
No sandbox environment exists. Output is an AI-generated draft for review, not a binding proposal, and it does not create a project or account.
For a dedicated integration, email [email protected].
Versioning and changes
The current API version is 1.0.0, as stated in /openapi.json. Breaking changes will come with a new version path. Field additions are not treated as breaking.