---
title: "Create a one-time signed upload URL for the org's storage bucket"
method: POST
path: "/api/v0beta1/storage/uploads"
tags: ["Uploads"]
---

# Create a one-time signed upload URL for the org's storage bucket

`POST /api/v0beta1/storage/uploads`

## Request body

- CreateUploadRequest
  - `filename` string, required
  - `upsert` boolean

## Response `201`

Signed upload URL. PUT the file body to `upload_url` using the returned `token`; valid for `expires_in` seconds, single use.

- UploadResponse
  - `bucket` string, required
  - `path` string, required
  - `upload_url` string, required
  - `token` string, required
  - `expires_in` integer, required

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `500` — Error
- `502` — Error

---

[API](https://skmtc.net/amika/apis/amika-api.md) · [All operations](https://skmtc.net/amika/apis/amika-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amika/amika-api/revisions/664536fccd0e/schema)
