Comments

List project comment threads

Changed on

Returns comment threads in the project, newest first within the matched set. Filter with status (open, resolved, or all), anchor (canvas, generation, or all), node_id (canvas node UUID or short id such as n7; unknown short ids are rejected), and query (plain-text match across live comments). Generation review threads include generation_id. Missing and inaccessible projects both return 404. Guests who can view or comment on the project can list threads; they do not need edit or generate permission.

get/projects/{projectId}/comment-threads

Request

  • Base URL
    https://app.flora.ai/api/v1
  • URL
    https://app.flora.ai/api/v1/projects/{projectId}/comment-threads
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Project identifier

Example:prj_abc123

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Opaque cursor for fetching the next page

Example:eyJvZmZzZXQiOjIwfQ
querystring

Search query

Example:logo
status'open' | 'resolved' | 'all'

Filter by thread status. Omit or all for every thread.

node_idstring

Only threads pinned to this canvas node

Example:n7
anchor'canvas' | 'generation' | 'all'

Filter by pin location. Omit or all for every thread.

Response

Comment threads returned.

Example response

{
  "comment_threads": [
    {
      "comment_thread_id": "cth_abc123",
      "project_id": "prj_abc123",
      "workspace_id": "ws_abc123",
      "generation_id": "run_abc123",
      "preview": {
        "comment_id": "cmt_abc123",
        "body": "Looks good — ship it.",
        "author": {
          "name": "Ada Lovelace"
        }
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJvZmZzZXQiOjIwfQ"
  }
}

Changes

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • info

      endpoint added