순서 변경 Tier 3

PATCH/projects/{id}/files.orderCopied!

프로젝트 파일 표시 순서를 변경해요.

접근 가능한 사용자

사용자

접근 권한

프로젝트

프로젝트 소유자프로젝트 관리자프로젝트 멤버

프로젝트 접근 방식

로컬외부 연결게스트

동작 방식

files 배열에 담긴 순서대로 각 파일의 order가 0부터 다시 지정돼요.

배열에 포함되지 않은 파일은 기존 폴더와 order 값을 유지해요. 이 때문에 순서 변경 후 같은 폴더 안에서 여러 파일이 같은 order 값을 가질 수 있어요. order가 중복되면 생성일을 기준으로 정렬돼요.

중복을 피하려면 정렬하려는 폴더의 파일을 모두 포함한 전체 순서를 보내야 해요.

folder가 null이면 배열에 포함된 모든 파일이 폴더 없음 상태로 이동해요. folder.id를 지정하면 배열에 포함된 모든 파일이 해당 폴더로 이동하고, 배열 순서대로 order가 지정돼요.

Request

Body

folderobject?required

파일을 담을 대상 폴더 정보예요. `null`이면 폴더 없음으로 이동해요.

folder.idstring

파일을 담을 대상 폴더 ID

filesarrayrequired

새 order를 지정하고 대상 폴더로 이동할 파일 목록

files[].idstringrequired

순서 변경 대상 파일 ID

Path

idstringrequired

프로젝트 ID

Response

Returns 200 OK.

없음

Example

curl -X PATCH 'https://api.youvico.com/projects/6ba7b810-9dad-11d1-80b4-00c04fd430c8/files.order' \
  -H 'Authorization: Bearer xoau.aB3xK9p2QwR7sT4uV1nM8oP5qL6rN0yZ7eF2gH4jK...' \
  -H 'Content-Type: application/json' \
  -d '{
    "folder": {
      "id": "7ca7b810-9dad-11d1-80b4-00c04fd430c8"
    },
    "files": [
      { "id": "123e4567-e89b-12d3-a456-426614174000" },
      { "id": "8da7b810-9dad-11d1-80b4-00c04fd430c8" },
      { "id": "9ea7b810-9dad-11d1-80b4-00c04fd430c8" }
    ]
  }'