Draft reviews

Create a draft or Brainstorming Review session, optionally with initial file content.

File content fields are literal UTF-8 payloads. Commentary never treats submitted paths as local files to read.

post/api/v1/draft-reviews

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/draft-reviews
  • Auth: HTTP bearer

Headers

X-Commentary-Workspace-Idstring

Must match the credential workspace. This header cannot widen grant authority.

X-Correlation-Idstring

Request body

titlestring required
descriptionstring
mode'draft' | 'brainstorming'
sourceType'api' | 'mcp' | 'cli' | 'agent_api'
agentAliasstring nullable

Stable per-agent identifier for agent-authored activity. clientName is not a substitute; the connected human identity remains visible.

Response

Successful response.

okunknown
sessionIdstring
reviewUrlstring uri

Changes

No recorded changes to this operation across all 1 revision of this API.