Skip to content
campaiDeveloper
campai.com

Misc ยท Drive

POST/{organizationId}/misc/drive/delete

Delete items

Deletes the specified drive files and folders, including everything inside the folders. Provide organizationId, folderIds, and fileIds; each ID array must contain unique IDs and may have at most 500 entries. The endpoint returns no value.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller must have organization access and the drive.remove permission.

Request

Path parameters

  • organizationIdidrequired

Body

Content-Type: application/json

  • folderIdsid[]required

    at most 500 items

  • fileIdsid[]required

    at most 500 items

Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/misc/drive/delete' \
  --header 'X-API-Key: YOUR_API_KEY'

No request that worked has been recorded yet, so the body is not shown.

Response

200 Successful response

No response body is specified.

What else happens

  • Matching file records, including files inside selected folders, are deleted from driveFiles.
  • When files are deleted, references to them as folder cover files are cleared.
  • Matching folder records, including descendants of selected folders, are deleted from driveFolders.
  • The contentUpdatedAt timestamp is updated on affected parent folders and their ancestors.
  • Deleting files reduces cached driveStorage usage by their stored file and thumbnail bytes.
  • Deleted files' storage resources and thumbnails are removed after the transaction.

Errors

Other errors

StatusErrorWhen
403You can only work inside folders shared with youFor assigned-only drive access, if a requested item's parent folder is not shared with the caller, the endpoint returns 403 FORBIDDEN with key misc.drive.sharedFoldersOnly.

Errors nearly every request can meet are listed under Errors.