프로젝트 댓글 목록 Tier 4

GET/api/projects/:id/commentsCopied!

프로젝트의 최상위 댓글을 생성 시간순으로 반환합니다. 커서 페이지네이션을 사용합니다.

예시

SDK

const comments = await client.comments.listForProject("bdbff5de-96d7-468f-9db0-85fe28bd6b62");

CLI

youvico comment list --project bdbff5de-96d7-468f-9db0-85fe28bd6b62

cURL

curl 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Project brief is ready for review.",
      "anchor": null,
      "duration": null,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "attachments": [],
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://cdn.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa"
  }
}

INFO

삭제된 최상위 프로젝트 댓글에 남아 있는 답글이 있으면 해당 댓글이 계속 반환될 수 있습니다. 삭제된 댓글이 반환되면 content, anchor, duration, author는 null이고 attachments는 빈 배열입니다.

요청

경로

idstringrequired

프로젝트 ID

쿼리

nextstring

다음 페이지 커서

prevstring

이전 페이지 커서

INFO

next와 prev를 모두 지정하지 않으면, 가장 최근에 생성된 프로젝트 댓글 25개를 반환합니다.

응답

200 OK를 반환합니다.

dataarray

댓글

data[].idstring

댓글 ID

Example: 2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6

data[].contentstring?

댓글 내용

Example: Project brief is ready for review.

data[].anchornumber?

프로젝트 댓글에서는 항상 `null`입니다.

Example: null

data[].durationnumber?

프로젝트 댓글에서는 항상 `null`입니다.

Example: null

data[].createdAtstring

댓글 생성 일시

Example: 2026-04-10 08:00:00.000000

data[].updatedAtstring

댓글 마지막 수정 일시

Example: 2026-04-10 08:10:00.000000

data[].attachmentsarray

댓글 첨부파일 목록

data[].attachments[].idstring

댓글 첨부파일 ID

Example: CA1234567890ABCD

data[].attachments[].namestring

첨부파일 이름

Example: review-note.pdf

data[].attachments[].urlstring

첨부파일 URL

Example: https://cdn.youvico.com/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/comments/CA1234567890ABCD/A1b2C3d4E5f6G7h8.pdf

data[].attachments[].mimeTypestring?

첨부파일 MIME 타입

Example: application/pdf

data[].attachments[].sizenumber

첨부파일 크기(바이트)

Example: 1250000

data[].authorobject?

댓글 작성자

data[].author.idstring

작성자 사용자 ID

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

data[].author.namestring

작성자 표시 이름

Example: Jin Seo

data[].author.avatarUrlstring?

작성자 아바타 URL

Example: https://cdn.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif

pageobject

페이지네이션 커서

page.nextstring?

다음 페이지 커서

Example: null

page.prevstring?

이전 페이지 커서

Example: MjAyNi0wNC0xMFQwODowMDowMC4wMDBa