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

# List task comments

> Lists task comments from the Tasks marketplace app installed on the workspace. The request is proxied to the app's comments API. Requires the Tasks app to be installed.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/comments
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/comments:
    get:
      tags:
        - Comments
      summary: List task comments
      description: >-
        Lists task comments from the Tasks marketplace app installed on the
        workspace. The request is proxied to the app's comments API. Requires
        the Tasks app to be installed.
      operationId: get_v1-comments
      parameters:
        - description: Maximum number of comments to return
          in: query
          name: limit
          schema:
            type: integer
        - description: Pagination cursor returned by a previous list response
          in: query
          name: nextToken
          schema:
            type: string
        - description: Filter comments to a single task by its id
          in: query
          name: taskId
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/marketplace_application.TaskCommentList'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Invalid query parameter for the app resource
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            App not found, not installed on the workspace, or app resource not
            found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: App API rejected the request as unprocessable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: App API rate limit exceeded
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: App API request failed or unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    marketplace_application.TaskCommentList:
      properties:
        data:
          items:
            $ref: '#/components/schemas/marketplace_application.TaskComment'
          type: array
        nextToken:
          description: base64 encoded JSON representing a NextToken
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
    marketplace_application.TaskComment:
      properties:
        authorId:
          description: AuthorID is the identifier of the user who authored the comment.
          example: 64734088-94c7-47dd-b2fe-e5ac7e5cfaf4
          type: string
        content:
          description: Content is the body text of the comment.
          example: Looks good, ready to ship.
          type: string
        createdAt:
          description: Created is the RFC 3339 timestamp at which the object was created.
          example: '2024-01-15T09:30:00Z'
          format: date-time
          type: string
        deleted:
          description: >-
            Deleted is true when the object has been deleted; present only on
            delete responses.
          example: true
          type: boolean
        id:
          description: ID is the unique identifier of the object.
          example: 550e8400-e29b-41d4-a716-446655440000
          type: string
        object:
          allOf:
            - $ref: '#/components/schemas/constants.ApiObject'
          description: Object is the type of the object (e.g. "client", "company").
        taskId:
          description: TaskID is the identifier of the task this comment belongs to.
          example: 550e8400-e29b-41d4-a716-446655440000
          type: string
        updatedAt:
          description: >-
            Updated is the RFC 3339 timestamp at which the object was last
            updated.
          example: '2024-02-20T14:05:00Z'
          format: date-time
          type: string
      type: object
    constants.ApiObject:
      enum:
        - client
        - internalUser
        - company
        - customField
        - customFieldOption
        - file
        - fileChannel
        - folder
        - messageChannel
        - message
        - notification
      type: string
      x-enum-varnames:
        - ApiObjectClient
        - ApiObjectInternalUser
        - ApiObjectCompany
        - ApiObjectCustomField
        - ApiObjectCustomFieldOption
        - ApiObjectFile
        - ApiObjectFileChannel
        - ApiObjectFolder
        - ApiObjectMessageChannel
        - ApiObjectMessage
        - ApiObjectNotification
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````