> ## Documentation Index
> Fetch the complete documentation index at: https://doc.octopusx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Management Overview

> A summary of object storage presigned upload APIs and how they integrate with image and video tasks.

# Upload Management

Upload management currently exposes one public documentation endpoint: `PUT /v1/file/upload`. It returns to the client an object storage URL that can be directly used for a `PUT` upload.

<CardGroup cols={2}>
  <Card title="Upload File" icon="upload" href="/en/uploads/image-upload">
    Generate an object storage presigned `PUT` URL and return the `download_url` after upload.
  </Card>

  <Card title="Downstream Usage" icon="link">
    Pass the uploaded `download_url` to `/v1/images/*`, `/mj/*`, or other endpoints that accept public asset URLs.
  </Card>
</CardGroup>

## Route List

| Method | Path              | Description                                   |
| ------ | ----------------- | --------------------------------------------- |
| `PUT`  | `/v1/file/upload` | Create an object storage presigned upload URL |

## Related Pages

* [Image Series Overview](../images/overview)
* [Video Series Overview](../videos/overview)
