> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List a task's comments

> The comments on a task, oldest first, with the people each one mentions.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/objects/task/records/{task_id}/comments
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/objects/task/records/{task_id}/comments:
    get:
      tags:
        - comments
      summary: List a task's comments
      description: The comments on a task, oldest first, with the people each one mentions.
      operationId: comments_list_task
      parameters:
        - in: path
          name: task_id
          required: true
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            type: integer
        - description: '`next_cursor` from the previous page'
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: null
        - description: Only comments with this visibility
          in: query
          name: visibility
          required: false
          schema:
            anyOf:
              - enum:
                  - internal
                  - external
                type: string
              - type: 'null'
            default: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommentPage'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    CommentPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Comment'
          title: Data
          type: array
        has_more:
          default: false
          title: Has More
          type: boolean
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      required:
        - data
      title: CommentPage
      type: object
    Comment:
      properties:
        author:
          anyOf:
            - type: string
            - type: 'null'
          description: The author's person id
          title: Author
        author_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Author Name
        author_type:
          anyOf:
            - enum:
                - user
                - stella
                - workflow
              type: string
            - type: 'null'
          description: user (a person), stella (Statisfy AI) or workflow (an automation)
          title: Author Type
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Created At
        id:
          title: Id
          type: string
        mentions:
          description: The ids of the people the text mentions, in order, each once
          items:
            type: string
          title: Mentions
          type: array
        project:
          anyOf:
            - type: string
            - type: 'null'
          description: The id of the project the comment is on; null on a task comment
          title: Project
        synced:
          description: >-
            True when the comment came from a tool synced with the task, such as
            Jira
          title: Synced
          type: boolean
        task:
          anyOf:
            - type: string
            - type: 'null'
          description: The id of the task the comment is on; null on a project comment
          title: Task
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Updated At
        value:
          description: The text, with its mentions as [@Name](user:<person id>)
          title: Value
          type: string
        visibility:
          description: >-
            internal (your team only, the default) or external (also shown in
            the customer's portal)
          enum:
            - internal
            - external
          title: Visibility
          type: string
      required:
        - id
        - task
        - project
        - value
        - mentions
        - visibility
        - author
        - author_name
        - author_type
        - synced
        - created_at
        - updated_at
      title: Comment
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.