Skip to main content
POST
/
s3
/
entries
curl -X POST https://app.drime.cloud/api/v1/s3/entries \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "71ea55f2-1ba7-46ad-98b7-db487ecac2f6",
    "size": 87965,
    "clientName": "document.pdf",
    "clientMime": "application/pdf",
    "clientExtension": "pdf",
    "workspaceId": 0,
    "parentId": null
  }'

{
  "fileEntry": {
    "name": "document.pdf",
    "file_name": "71ea55f2-1ba7-46ad-98b7-db487ecac2f6",
    "mime": "application/pdf",
    "file_size": 87965,
    "type": "pdf",
    "extension": "pdf",
    "workspace_id": 0,
    "owner_id": 15843,
    "id": 488163222,
    "hash": "NDg4MTYzMjIyfA",
    "path": "488163222",
    "url": "api/v1/file-entries/488163222",
    "created_at": "2025-12-22T13:45:07.000000Z",
    "updated_at": "2025-12-22T13:45:07.000000Z"
  },
  "status": "success"
}

​
Overview

Creates a file entry in the Drime database after successfully uploading a file to S3/R2. This is the final step in both simple and multipart upload flows.

​
Request Body

​
filename
string
required
The UUID filename from the S3 key (last segment)
​
size
integer
required
File size in bytes
​
clientName
string
required
Original filename to display to users
​
clientMime
string
MIME type of the file
​
clientExtension
string
File extension without dot
​
workspaceId
integer
Workspace ID. Use 0 for personal workspace.
​
parentId
integer
Parent folder ID. Use null for root.
​
relativePath
string
Folder path for auto-creation (overrides parentId)

​
Response

​
fileEntry
object
The created file entry object
​
status
string
Request status (success)
curl -X POST https://app.drime.cloud/api/v1/s3/entries \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "71ea55f2-1ba7-46ad-98b7-db487ecac2f6",
    "size": 87965,
    "clientName": "document.pdf",
    "clientMime": "application/pdf",
    "clientExtension": "pdf",
    "workspaceId": 0,
    "parentId": null
  }'

{
  "fileEntry": {
    "name": "document.pdf",
    "file_name": "71ea55f2-1ba7-46ad-98b7-db487ecac2f6",
    "mime": "application/pdf",
    "file_size": 87965,
    "type": "pdf",
    "extension": "pdf",
    "workspace_id": 0,
    "owner_id": 15843,
    "id": 488163222,
    "hash": "NDg4MTYzMjIyfA",
    "path": "488163222",
    "url": "api/v1/file-entries/488163222",
    "created_at": "2025-12-22T13:45:07.000000Z",
    "updated_at": "2025-12-22T13:45:07.000000Z"
  },
  "status": "success"
}
If you provide relativePath, folders will be automatically created and the file placed in the correct location.