Skip to main content
POST
/
api
/
file
/
upload
/
{ownerType}
/
{ownerId}
Uploads a single file and attaches it to the specified owner entity. Returns the created DataFile record so callers (CLI / SDK / migration scripts) can capture the new file id without a follow-up list-and-filter call.
curl --request POST \
  --url https://{install}/api/file/upload/{ownerType}/{ownerId} \
  --header 'Authorization: Bearer <token>'

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
ownerType
integer
required

The type of entity that will own the file (e.g. Item, Annotation).

​
ownerId
string
required

The unique identifier of the owning entity.

Response

The file was uploaded; body is the DataFile record.