Misc ยท Drive
Copy files
Copies each requested file next to its original. Provide an organizationId and up to 100 unique fileIds. The endpoint returns no content.
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.insertpermission. - For assigned-only drive access, each found file must be inside a folder shared with the caller.
Request
Path parameters
-
organizationIdidrequired
Body
Content-Type: application/json
-
fileIdsid[]requiredat most 100 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/copy' \
--header 'X-API-Key: YOUR_API_KEY'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/misc/drive/copy", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/misc/drive/copy', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
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
- Inserts a
driveFilesrecord for each copy. - Updates
contentUpdatedAton the copies' folders and their ancestor folders, when present.
Errors
Other errors
| Status | Error | When |
|---|---|---|
| 403 | You can only work inside folders shared with you | Returns 403 with key misc.drive.sharedFoldersOnly if assigned-only drive access does not allow work in a requested file's folder. |
| 404 | The file was not found | Returns 404 with key routes.misc.drive.noFile if any requested file is not found in the organization. |
| 404 | The file was not found | Returns 404 with key routes.misc.drive.noFile if a file's stored resource cannot be copied. |
Errors nearly every request can meet are listed under Errors.