All Products
Search
Document Center

Alibaba Cloud DevOps:ListWorkitemComments - List workitem comments

Last Updated:Jul 06, 2026

Service endpoints and authorization

Product

Resource

Required permissions

Projex

workitem comments

read-only

Request syntax

Region edition

GET https://{domain}/oapi/v1/projex/workitems/{id}/comments

Request headers

Parameter

Type

Required

Description

Example

x-yunxiao-token

string

Yes

Your Alibaba Cloud DevOps personal access token.

pt-0fh3****0fbG_35af****0484

Request parameters

Parameter

Type

Location

Required

Description

Example

id

string

path

Yes

The unique identifier of the workitem.

Request examples

Region edition

curl -X 'GET' \
  'https://{domain}/oapi/v1/projex/workitems/{id}/comments' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

Response parameters

Parameter

Type

Description

Example

-

array

An array of comment objects.

-

object

A comment object.

content

string

The comment content.

test

contentFormat

string

The format of the comment content. Valid values: "RICHTEXT" or "MARKDOWN".

RICHTEXT

gmtCreate

string

The creation time.

gmtModified

string

The last modified time.

id

string

The ID of the comment.

id-xxx

parentId

string

The parent comment ID.

1222333

top

boolean

Indicates whether the comment is pinned.

false

topTime

string

The time when the comment was pinned.

user

object

The user who posted the comment.

id

string

The user ID.

674d96abd497cd558d68****

name

string

The name of the user.

name-xxx

Response example

[
    {
        "content": "test",
        "contentFormat": "RICHTEXT",
        "gmtCreate": "",
        "gmtModified": "",
        "id": "id-xxx",
        "parentId": "1222333",
        "top": false,
        "topTime": "",
        "user": {
            "id": "674d96abd497cd558d68****",
            "name": "name-xxx"
        }
    }
]

Error codes

See the Error Code Center for a list of API error codes.