파일 조회
GET
https://api.youvico.com/api/files/:id- MCP 도구
- get_fileGet File
- 요청 제한
- Default
- API 권한
- files:read
파일을 조회합니다.
예시
curl 'https://api.youvico.com/api/files/FX1234567890ABCD' \
-H 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"id": "FX1234567890ABCD",
"createdAt": "2026-09-01 09:00:00.271845",
"updatedAt": "2026-09-10 10:30:00.583126",
"name": "launch-cut.mp4",
"description": "Final review upload",
"mode": "LOCAL",
"mimeType": "video/mp4",
"status": "UPLOADED",
"tag": "NEED_REVIEW",
"size": 82415032,
"allowRestricted": true,
"folder": {
"id": "DX1234567890ABCD"
},
"uploader": {
"id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
"name": "Jin Seo",
"avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
},
"project": {
"id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
}
}
}
요청
curl -X GET 'https://api.youvico.com/api/files/FX1234567890ABCD' \
-H 'Authorization: Bearer YOUR_API_KEY'
응답200 OK
{
"data": {
"id": "FX1234567890ABCD",
"createdAt": "2026-09-01 09:00:00.271845",
"updatedAt": "2026-09-10 10:30:00.583126",
"name": "launch-cut.mp4",
"description": "Final review upload",
"mode": "LOCAL",
"mimeType": "video/mp4",
"status": "UPLOADED",
"tag": "NEED_REVIEW",
"size": 82415032,
"allowRestricted": true,
"folder": {
"id": "DX1234567890ABCD"
},
"uploader": {
"id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
"name": "Jin Seo",
"avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
},
"project": {
"id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
}
}
}
요청
경로
idstringrequired파일 ID
응답
200 OK를 반환합니다.
dataobject파일
data.idstring파일 ID
예시: FX1234567890ABCD
data.createdAtstring파일 생성 일시
예시: 2026-09-01 09:00:00.271845
data.updatedAtstring파일 마지막 수정 일시
예시: 2026-09-10 10:30:00.583126
data.namestring파일 이름
예시: launch-cut.mp4
data.descriptionstring?파일 설명
예시: Final review upload
data.modestring파일 모드
가능한 값: LOCALYOUTUBE
예시: LOCAL
data.mimeTypestring?MIME 타입
예시: video/mp4
data.statusstring파일 상태
가능한 값: UPLOADINGUPLOADEDFAILED
예시: UPLOADED
data.tagstring리뷰 태그
가능한 값: IN_PROGRESSNEED_REVIEWNEED_EDITON_HOLDAPPROVEDREJECTEDCLOSED
예시: NEED_REVIEW
data.sizenumber파일 크기(바이트)
예시: 82415032
data.allowRestrictedboolean제한된 리뷰어가 파일에 접근할 수 있는지 여부
예시: true
data.folderobject?상위 폴더. 프로젝트 루트면 null
data.uploaderobject업로더
data.projectobject상위 프로젝트