curl -X POST https://app.drime.cloud/api/v1/entry/getAvailableName \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "report.pdf",
"parentId": null,
"workspaceId": 0
}'
const response = await fetch('https://app.drime.cloud/api/v1/entry/getAvailableName', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'report.pdf',
parentId: null,
workspaceId: 0
})
});
const { name } = await response.json();
console.log(`Use filename: ${name}`); // "report (1).pdf"
import requests
response = requests.post(
'https://app.drime.cloud/api/v1/entry/getAvailableName',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'name': 'report.pdf',
'parentId': None,
'workspaceId': 0
}
)
new_name = response.json()['name']
print(f'Use filename: {new_name}') # "report (1).pdf"
{
"name": "report (1).pdf"
}
{
"name": "report (2).pdf"
}
Files & Folders
Get Available Name
Get an alternative filename when duplicates exist
POST
/
entry
/
getAvailableName
curl -X POST https://app.drime.cloud/api/v1/entry/getAvailableName \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "report.pdf",
"parentId": null,
"workspaceId": 0
}'
const response = await fetch('https://app.drime.cloud/api/v1/entry/getAvailableName', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'report.pdf',
parentId: null,
workspaceId: 0
})
});
const { name } = await response.json();
console.log(`Use filename: ${name}`); // "report (1).pdf"
import requests
response = requests.post(
'https://app.drime.cloud/api/v1/entry/getAvailableName',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'name': 'report.pdf',
'parentId': None,
'workspaceId': 0
}
)
new_name = response.json()['name']
print(f'Use filename: {new_name}') # "report (1).pdf"
{
"name": "report (1).pdf"
}
{
"name": "report (2).pdf"
}
Overview
When a file with the same name already exists, this endpoint suggests an alternative filename by appending a counter (e.g., “file.txt” becomes “file (1).txt”).Request Body
string
required
Original filename that needs an alternative
integer
Parent folder ID where the file will be uploaded. Use
null for root.integer
Workspace ID
Response
string
Suggested alternative filename with counter
curl -X POST https://app.drime.cloud/api/v1/entry/getAvailableName \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "report.pdf",
"parentId": null,
"workspaceId": 0
}'
const response = await fetch('https://app.drime.cloud/api/v1/entry/getAvailableName', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'report.pdf',
parentId: null,
workspaceId: 0
})
});
const { name } = await response.json();
console.log(`Use filename: ${name}`); // "report (1).pdf"
import requests
response = requests.post(
'https://app.drime.cloud/api/v1/entry/getAvailableName',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'name': 'report.pdf',
'parentId': None,
'workspaceId': 0
}
)
new_name = response.json()['name']
print(f'Use filename: {new_name}') # "report (1).pdf"
{
"name": "report (1).pdf"
}
{
"name": "report (2).pdf"
}
Use this in conjunction with
/uploads/validate to handle duplicate files gracefully.⌘I

