---
title: "create a file"
method: POST
path: "/v2/file/upload"
tags: ["File"]
---

# create a file

`POST /v2/file/upload`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/v2/file/upload`
- Auth: API key in header `OAuth`

create a file.

## Request body

- CreateFileRequestCreateFileRequestBody
  - `type` string
  - `data` string
  - `name` string
  - `size` integer
  - `preview` boolean

## Response `200`

A successful response.

- CreateFileResponse
  - `success` boolean
  - `data` CreateFileResponseCreateFileResponseBody
    - `file` ModelFile
      - `id` integer
      - `name` string
      - `type` string
      - `size` integer
      - `session` integer
      - `linkId` string
      - `tags` string
      - `tempId` string
      - `width` integer
      - `height` integer
      - `downloadLink` string
      - `previewLink` string
      - `p5050Link` string
      - `dynamicLink` string
      - `creator` integer
      - `created` string, date-time
      - `modified` string, date-time
    - `filePreviews` ModelFilePreview[]
      - `id` integer
      - `fileId` integer
      - `width` integer
      - `height` integer
      - `size` integer
      - `link` string
      - `secureLink` string
      - `creator` integer
      - `created` string, date-time
      - `modified` string, date-time

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)