문서로 건너뛰기
API

파일 일괄 삭제

한 번의 호출로 파일을 최대 100개, 각각 `DELETE /files/{id}`가 하나를 삭제하는 방식대로 삭제합니다. 파일 페이지에서 여러 개를 선택해 삭제하는 것과 같습니다.

POSTapi.openemail.uk/files/batch-delete

본인 키로 워크스페이스에 실제 호출을 실행합니다.

POST /files/batch-delete

한 번의 호출로 파일을 최대 100개, 각각 DELETE /files/{id}가 하나를 삭제하는 방식대로 삭제합니다. 파일 페이지에서 여러 개를 선택해 삭제하는 것과 같습니다.

예시

threads:write가 필요합니다. ids는 파일 id를 1개에서 100개까지 받으며, 다른 필드는 모두 422 unknown_parameter입니다.

curl
curl -X POST "$OE/files/batch-delete" -H "$AUTH" -H 'content-type: application/json' -d '{  "ids": ["file_0c4e7a91d2b84f63a5e19b7d", "file_6bb640f5b99e47deb758f1f5", "file_9e2b41c7a0f35d8e6b1c4a72"]}'
응답
{  "object": "file_batch_delete",  "deleted": ["file_0c4e7a91d2b84f63a5e19b7d"],  "kept": [    {      "id": "file_6bb640f5b99e47deb758f1f5",      "filename": "invoice-0912.pdf",      "usage": "received",      "reason": "It came in on a message, so it stays with that message."    }  ],  "missing": ["file_9e2b41c7a0f35d8e6b1c4a72"]}

일부 파일은 삭제되고 일부는 남는 호출은 오류가 아닙니다. deleted는 삭제된 것을, kept는 사용 중인 각 파일을 그 usage 및 문장으로 된 reason과 함께, missing은 알 수 없거나 이미 삭제되었거나 제한된 키가 가진 주소 밖에 있는 id를 나열합니다.

각 파일은 삭제되는 순간 다시 확인되므로, 목록을 받은 뒤 사용되기 시작한 파일은 사라지지 않고 남습니다. 되돌릴 수 없습니다.