---
title: "Upload device asset file"
method: POST
path: "/v1/files/{fileType}"
tags: ["Device asset file management"]
---

# Upload device asset file

`POST /v1/files/{fileType}`

## Request

- Base URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration`
- URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration/v1/files/{fileType}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-protect-api/docs/v1/files/:fileType/post.ts> (a function with typed inputs; its response is checked against the schema)

Upload a new device asset file

## Path parameters

- `fileType` 'animations', required: Device asset file type

## Request body `multipart/form-data`

- string, binary: A binary file with one of these MIME types: image/gif, image/jpeg, image/png, audio/mpeg, audio/mp4, audio/wave, audio/x-caf}

## Response `200`

Processed and persisted device asset

- FileSchema
  - `name` string, required: Unique ID for the asset file
  - `type` 'animations', required: Device asset file type
  - `originalName` string: Original filename of the uploaded file
  - `path` string, required: Path to the file on the filesystem

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ubiquiti/apis/unifi-protect-api.md) - [All operations](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/revisions/e341e1381db1?raw)