Skip to main content
GET
/
api
/
file
/
{id}
Retrieves a single file's metadata by its identifier. Useful when you have the file id (e.g. from an upload response) and want to verify existence or fetch metadata without listing the owner's full file list.
curl --request GET \
  --url https://{install}/api/file/{id} \
  --header 'Authorization: Bearer <token>'
{
  "entity": "<string>",
  "owner": 123,
  "ownerId": "<string>",
  "uid": "<string>",
  "filename": "<string>",
  "mimeType": "<string>",
  "length": 123,
  "tenantId": "<string>",
  "id": "<string>",
  "created": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "updated": "2023-11-07T05:31:56Z",
  "updatedBy": "<string>",
  "deleted": true
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token. Obtain via the OAuth 2.0 token endpoint.

Path Parameters

​
id
string
required

The unique identifier of the file.

Response

The file metadata.

​
entity
null | string
​
owner
integer
​
ownerId
string
​
uid
string
​
filename
string
​
mimeType
string
​
length
integer<int64>
​
tenantId
string
​
id
string
​
created
string<date-time>
​
createdBy
string
​
updated
string<date-time>
​
updatedBy
string
​
deleted
boolean