DeeCee.ai Agentic API

Changelog

Agentic API version history.

Unreleased

  • New synthesize_context, update_decision_context, assess_decision, and apply_decision_setup tools/endpoints — turn a free-form interview_next_question conversation into a saved decision context, then get a complexity/framework/title recommendation to review and commit before running analysis. start_decision_brief's decision_context is now optional to support this conversational path.
  • New advance_stage tool/endpoint (POST /v1/decisions/{id}/advance) — runs exactly the next framework stage and derives the stage index and prior-stage context automatically. Now the recommended default over generate_framework_analysis, which runs every stage in one request and can exceed the request time limit on longer frameworks.
  • Interactive, Swagger-style API Endpoint Reference generated from the OpenAPI spec (one page per endpoint, with request/response schemas and code samples) — replaces the hand-maintained endpoint table on the API Reference page
  • New list_use_cases tool/endpoint (GET /v1/use-cases) and optional use_case_id on start_decision_brief — steers interview_next_question toward a known use case's guiding questions instead of a generic prompt. Pro-tier use cases return 403 for Free-tier callers, matching the web app's gating.
  • New attach_document tool/endpoint (POST /v1/decisions/{id}/documents) — attach a document to a decision by URL for use as context during analysis, with the same security validation and storage-quota checks as the web app's upload flow. Free (no LLM call).
  • New refine_stage / apply_stage_revision tools and endpoints (POST /v1/decisions/{id}/refine, .../refine/apply) — ask the AI to revise a completed stage, review the suggested revision, then commit it (as-is or edited). Suggest-then-confirm: refine_stage never saves. Each applied revision is recorded in the stage's version history.
  • New export_brief tool/endpoint (POST /v1/decisions/{id}/export) — export a brief as Markdown, DOCX, or PDF. PDF is available on every plan; Markdown and DOCX require Pro, Beta, or Admin, matching the web app.

v1.0.0-lean

Initial release.

  • REST API: start_decision_brief, list_frameworks, list_decisions, get_decision, get_recommendation, interview_next_question, generate_framework_analysis, get_job
  • MCP server (Streamable HTTP) with the same 8 tools, plus frameworks/decisions resources and a run_full_decision guided prompt
  • Custom API keys (dc_live_/dc_test_) managed at Settings → API Keys
  • Tier-based rate limiting and idempotency replay
  • OpenAPI 3.1 spec at /openapi.json

Not yet included — see the v2 polish backlog for what's planned next: a standalone stdio MCP package, additional quickstart guides, sign-in with your DeeCee.ai account (OAuth) for MCP clients, and OAuth2 client credentials for enterprise.