---
title: "Create a one-time upload URL for a Workspace file"
method: POST
path: "/v1/workspaces/{workspaceID}/files/upload-url"
---

# Create a one-time upload URL for a Workspace file

`POST /v1/workspaces/{workspaceID}/files/upload-url`

## Request

- Base URL: `https://api.plori.ai`
- URL: `https://api.plori.ai/v1/workspaces/{workspaceID}/files/upload-url`
- Auth: HTTP bearer

Returns a URL that accepts one multipart upload (form part file, up to 32 MiB) of the named file without a bearer token, for 10 minutes. The upload replaces the file version that existed when the URL was created, or creates the file. After one upload, or after the file changes, the URL is refused. Access is the same as POST /v1/workspaces/{workspaceID}/files/upload.

## Path parameters

- `workspaceID` string, uuid, required

## Query parameters

- `path` string
- `name` string, required

## Response `200`

Upload URL created.

- object
  - `url` string, required
  - `path` string, required
  - `expires_at` string, date-time, required
  - `max_bytes` integer, required

## Other responses

- `400`: Malformed request.
- `401`: Missing or invalid credential.
- `404`: No such resource.
- `409`: A deleting Workspace returns code workspace_deleting.

---

[API](https://skmtc.dev/plori/apis/plori-rest-api.md) · [All operations](https://skmtc.dev/plori/apis/plori-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plori/apis/plori-rest-api/revisions/15c4f9260dff?raw)