Draft reviews

Upload a new draft or Brainstorming Review revision from literal file content.

post/api/v1/draft-reviews/{sessionId}/revisions

Request

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

Path parameters

sessionIdstring required

Draft review or Research session id.

Headers

X-Commentary-Workspace-Idstring

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

X-Correlation-Idstring

Request body

summarystring
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.

addressedThreadIdsstring[]

Brainstorming Review thread ids to mark addressed after the literal-content revision is accepted. Requires commentary.comments.status.

Response

Successful response.

okunknown
changedFilesobject[]
addressedThreadIdsstring[]
sourceobject
noOpboolean

Changes

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