댓글 목록 (파일)

MCP 도구: list_file_commentsList File Comments
요청 제한: Default
API 권한: comments:read

파일의 댓글 목록을 조회합니다.

예시

bash

curl -X QUERY 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "sort": { "type": "createdAt", "direction": "asc" } }'

json

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Please tighten the logo safe area.",
      "anchor": 12000,
      "duration": 3000,
      "createdAt": "2026-04-10 08:00:00.482913",
      "updatedAt": "2026-04-10 08:05:12.118204",
      "deletedAt": null,
      "reply": {
        "count": 1,
        "lastCreatedAt": "2026-04-10 08:10:00.215374"
      },
      "attachments": [
        {
          "id": "CA1234567890ABCD",
          "name": "review-note.pdf",
          "mimeType": "application/pdf",
          "size": 1250000
        }
      ],
      "reactions": [
        {
          "type": "👍",
          "count": 2,
          "me": true
        }
      ],
      "parent": null,
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "WyIyMDI2LTA0LTEwIDA4OjAwOjAwLjQ4MjkxMyIsIjJmYjRlNjBiLTBkOWEtNDZmMy1hNGRjLWNiOWZlOGFkOWJlNiJd"
  }
}

요청

경로

idstringrequired

파일 ID

본문

sortobjectrequired

정렬 순서

sort.typestringrequired

정렬 기준 필드

Possible values: createdAtanchor

Example: createdAt

sort.directionstringrequired

정렬 방향

Possible values: ascdesc

Example: asc

keywordstring

2-255 characters

검색어

usersarray

1-20 items

댓글 작성자

users[].idstringrequired

UUID

작성자 사용자 ID

hasAnchorboolean

앵커가 있는 댓글인지 여부

nextstring

Maximum 2048 characters

page.next 커서

prevstring

Maximum 2048 characters

page.prev 커서

응답

200 OK를 반환합니다.

dataarray

data[].idstring

댓글 ID

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

data[].contentstring?

댓글 내용

Example: Please tighten the logo safe area.

data[].anchornumber?

동영상은 밀리초 단위 타임스탬프, 문서는 1부터 시작하는 페이지 번호

Example: 12000

data[].durationnumber?

anchor와 같은 단위의 댓글 구간 길이

Example: 3000

data[].createdAtstring

댓글 생성 일시

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

data[].updatedAtstring

댓글 마지막 수정 일시

Example: 2026-04-10 08:05:12.118204

data[].deletedAtstring?

댓글 삭제 일시

Example: null

data[].replyobject

답글 요약

data[].reply.countnumber

답글 수

Example: 1

data[].reply.lastCreatedAtstring?

최근 답글 생성 일시

Example: 2026-04-10 08:10:00.215374

data[].attachmentsarray

댓글 첨부파일

data[].attachments[].idstring

댓글 첨부파일 ID

Example: CA1234567890ABCD

data[].attachments[].namestring

첨부파일 이름

Example: review-note.pdf

data[].attachments[].mimeTypestring?

첨부파일 MIME 타입

Example: application/pdf

data[].attachments[].sizenumber

첨부파일 크기(바이트)

Example: 1250000

data[].reactionsarray

이모지별 리액션

data[].reactions[].typestring

이모지 문자

Example: 👍

data[].reactions[].countnumber

리액션 수

Example: 2

data[].reactions[].meboolean

내가 이 리액션을 추가했는지 여부

Example: true

data[].parentobject?

상위 댓글

Example: null

data[].parent.idstring

상위 댓글 ID

data[].authorobject?

댓글 작성자

data[].author.idstring

작성자 사용자 ID

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

data[].author.namestring

작성자 표시 이름

Example: Jin Seo

data[].author.avatarUrlstring?

작성자 아바타 URL

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

pageobject

페이지네이션 커서

page.nextstring?

다음 페이지 커서

Example: null

page.prevstring?

이전 페이지 커서

Example: WyIyMDI2LTA0LTEwIDA4OjAwOjAwLjQ4MjkxMyIsIjJmYjRlNjBiLTBkOWEtNDZmMy1hNGRjLWNiOWZlOGFkOWJlNiJd

댓글 목록 (파일) ​

예시 ​

요청 ​

경로 ​

본문 ​

응답 ​

댓글 목록 (파일)

예시

요청

경로

본문

응답