---
title: "Upload"
method: POST
path: "/api/v1/storage/upload"
tags: ["Storage"]
---

# Upload

`POST /api/v1/storage/upload`

## Request

- Base URL: `https://api.scade.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.scade.pro/api/v1/storage/upload`
- Auth: none declared

## Query parameters

- `acl` 'public-read' | 'private': An enumeration.
- `append_user_or_company_prefix` boolean: Append username or company (if user is staff) directory prefix

## Headers

- `x-company-id` string
- `x-auth-as-staff` boolean
- `x-auth-token` string

## Cookies

- `ory_kratos_session` string

## Request body `multipart/form-data`

- BodyUploadApiV1StorageUploadPost
  - `file` string, binary, required

## Response `200`

Successful Response

- FileData: Represents the result of an upload operation Attributes: public_url (HttpUrl | str): A public url for accessing the object status (bool): True or False if upload is successful
  - `public_url` union
    - string, uri
    - string
  - `status` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/scade/apis/scade-prod.md) - [All operations](https://skmtc.dev/scade/apis/scade-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/scade/apis/scade-prod/revisions/f3d7ba71abbc?raw)