PRD comments

PRD comment threads carry review feedback on an app’s PRD. Each thread anchors to a PRD entry id and holds a conversation of replies. Threads persist across versions; raisedOnVersion records the version the feedback was raised against. Authentication (all endpoints): entity access required — the entity’s publisher or a user it is shared with. Read-only reviewers can comment; PRD comments are collaboration metadata, not entity mutations. Unlike other Platform API resources, PRD comment responses use camelCase field names.

Thread shape

{
  "id": "…",
  "entryId": "tasks.member-can-add",
  "raisedOnVersion": "2026.07.08-101502",
  "status": "open",
  "createdBy": { "id": "…", "name": "Ada", "email": "ada@acme.com", "avatarUrl": null },
  "resolvedBy": null,
  "resolvedAt": null,
  "createdAt": "2026-07-10T09:12:00Z",
  "updatedAt": "2026-07-10T09:12:00Z",
  "replies": [
    { "id": "…", "body": "Should say overdue, not late", "createdAt": "…", "updatedAt": "…", "author": { "id": "…", "name": "Ada", "email": "ada@acme.com", "avatarUrl": null } }
  ]
}

List threads

GET /api/entities/{entityId}/prd-comments

Parameter	Type	Required	Description
`status`	query	No	`open` or `resolved`
`entryId`	query	No	Only threads anchored to this PRD entry

Returns { threads: [...] }, oldest first, with replies nested.

Create a thread

POST /api/entities/{entityId}/prd-comments

Parameter	Type	Required	Description
`entryId`	body	Yes	PRD entry the thread anchors to
`body`	body	Yes	Text of the thread’s first reply
`raisedOnVersion`	body	No	Version the feedback was raised against

Returns 201 with { thread }.

Resolve or reopen a thread

PATCH /api/entities/{entityId}/prd-comments/{threadId}

Parameter	Type	Required	Description
`status`	body	Yes	`open` or `resolved`

Resolving stamps resolvedBy and resolvedAt; reopening clears them. Returns { thread }.

Delete a thread

DELETE /api/entities/{entityId}/prd-comments/{threadId}

Only the thread’s creator may delete it (403 otherwise). Returns { success: true }.

Add a reply

POST /api/entities/{entityId}/prd-comments/{threadId}/replies

Parameter	Type	Required	Description
`body`	body	Yes	Reply text

Returns 201 with { reply } and bumps the thread’s updatedAt.

Delete a reply

DELETE /api/entities/{entityId}/prd-comments/{threadId}/replies/{replyId}

Only the reply’s author may delete it (403 otherwise). Deleting the last reply also deletes the thread. Returns { success: true, threadDeleted: boolean }.

Platform Docs

Synthetiq Desktop

Synthetiq CLI

App Framework

Services Framework

Workflows Framework

Platform API

Deployments

PRD comments

Thread shape

List threads

Create a thread

Resolve or reopen a thread

Delete a thread

Add a reply

Delete a reply

​Thread shape

​List threads

​Create a thread

​Resolve or reopen a thread

​Delete a thread

​Add a reply

​Delete a reply

Thread shape

List threads

Create a thread

Resolve or reopen a thread

Delete a thread

Add a reply

Delete a reply