---
title: "POST /api/v1/files/upload-file"
method: POST
path: "/api/v1/files/upload-file"
tags: ["REST API", "version 1.x.x", "files"]
---

# POST /api/v1/files/upload-file

`POST /api/v1/files/upload-file`

Upload a raw file and redirect to file state service

## Response `200`

OK

- object
  - `content-type` union, required
    - 'cc/folder-type'
    - 'cc/folder-type'
  - `content-hash` string, nullable, required
  - `id` string, required
  - `revision` integer, required
  - `source-path` string, nullable, required
  - `updated-at` string, required
  - `name` string, required
  - `created-at` string, required
  - `is-private` boolean, required
  - `metadata` union, required
    - unknown
    - object
      - `image-height` integer
      - `image-width` integer
      - `custom-thumb` boolean
      - `thumb-width` integer
      - `where-from` string
      - `color-palette` string
      - `has-thumb` boolean
      - `duration` number, double
      - `has-alpha` boolean
      - `is-animated` boolean
      - `modification` string
      - `thumb-hash` string
      - `creation` string
      - `thumb-height` integer
      - `orientation` integer
      - `is-motion-photo` boolean
    - object
  - `kind` 'cc/folder-kind' | 'cc/file-kind', required
  - `link` string, nullable, required
  - `ranking` string, required
  - `tag-ids` string[], nullable, required
  - `size` string, required
  - `rating` integer, nullable, required
  - `description` string, nullable, required
  - `parent-id` string, required

---

[API](https://skmtc.dev/pixcall/apis/sakura-api.md) · [All operations](https://skmtc.dev/pixcall/apis/sakura-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pixcall/sakura-api/revisions/10ed00ec068d/schema)