Beta

권한

요청으로 할 수 있는 일은 API 키나 앱 연결의 API 권한, 그리고 워크스페이스와 프로젝트에서의 내 역할로 정해집니다.

API 권한

각 엔드포인트의 레퍼런스 페이지에 필요한 API 권한이 표시됩니다. 키나 연결은 API 권한이 허용하는 엔드포인트만 호출할 수 있습니다. API 권한이 없으면 Ping만 호출할 수 있습니다.

API 권한허용하는 작업
projects:read프로젝트 검색과 조회, 보관 프로젝트와 삭제 예정 프로젝트 목록
projects:write프로젝트 생성, 수정, 보관, 보관 해제, 삭제 예약과 예약 취소
folders:read폴더 목록과 조회
folders:write폴더 생성, 수정, 삭제
files:read파일 목록과 조회, AI로 생성한 파일의 AI 작업 조회
files:write파일 업로드, 수정, 리뷰 태그 변경, 삭제
files:download파일 다운로드 URL 발급
ai:generateAI 모델 목록, AI 파일 생성과 예약 크레딧 예측, AI 생성 첨부 업로드
comments:read댓글, 답글, 리액션 목록과 조회
comments:write댓글, 리액션, 댓글 첨부 파일 생성, 수정, 삭제
comments:download댓글 첨부 파일 다운로드 URL 발급
workspace-members:read워크스페이스 멤버 목록
project-members:read프로젝트 멤버 목록
project-members:write프로젝트 멤버 추가, 수정, 제거
access-links:read액세스 링크 목록과 조회
access-links:write액세스 링크 생성, 수정, 삭제
access-links:read.key액세스 링크의 accessKey 확인. 이 API 권한이 없으면 accessKey는 null
skills:read스킬 목록과 조회, 스킬 버전 다운로드
skills:write스킬 생성, 수정, 삭제와 스킬 버전 생성, 삭제
schedules:read프로젝트 일정 목록과 조회
schedules:write프로젝트 일정 생성, 수정, 삭제
usage:read워크스페이스 사용량 조회. credits:read가 있으면 크레딧 현황도 반환
credits:read플랜 크레딧, 구매 크레딧, 멤버별 크레딧 목록. usage:read와 함께 있으면 워크스페이스 사용량에 크레딧 현황도 반환

역할

요청은 내 권한으로 동작합니다. 그래서 YouViCo 앱에서 열 수 있는 프로젝트에 똑같이 접근합니다.

  • 내가 참여한 프로젝트
  • 워크스페이스 전체에 공개된 프로젝트
  • 워크스페이스 소유자나 관리자라면 워크스페이스의 모든 프로젝트
  • 다른 워크스페이스가 내 워크스페이스와 연결한 프로젝트

프로젝트 역할이나 워크스페이스 역할이 필요한 엔드포인트는 레퍼런스 페이지에 허용된 역할이 표시됩니다.

일부 작업은 항목을 생성한 사람만 할 수 있습니다.

  • 댓글 수정과 삭제: 작성자
  • 파일 업로드 완료: 업로드를 시작한 사람
  • AI 생성 첨부 업로드 완료: 업로드를 시작한 사람
  • 댓글 첨부 파일 업로드 완료, 취소, 삭제: 업로드한 사람

제한 공개 파일

제한된 리뷰어는 자신에게 공개된 파일(allowRestricted가 true)만 볼 수 있습니다. 프로젝트에 참여하지 않고 워크스페이스 역할로 프로젝트에 접근한 경우도 같습니다.

플랜 기능

AI 파일 생성과 스킬은 해당 기능이 포함된 플랜에서만 사용할 수 있습니다.

보관된 프로젝트

보관된 프로젝트는 보관을 해제할 때까지 읽기 전용입니다. 다운로드 URL 발급, 프로젝트 멤버 제거, 액세스 링크 삭제는 계속 할 수 있습니다.