---
title: "Request file upload session"
method: GET
path: "/api/2/upload/{fileable}"
tags: ["Upload"]
---

# Request file upload session

`GET /api/2/upload/{fileable}`

Returns the temporary S3 credentials and the storage location (`key`) required for the upload.
If a naming conflict is detected, the conflicting File object is returned.

Usage:

- Pass the credentials to the S3 SDK constructor.
- Use the returned `key` property to set the destination path on S3.
- Keep the `version` string for step 3.

<aside class="info">Credentials expire after 60 minutes.</aside>

## Query parameters

- `size` integer, required — The size of the file in bytes
- `name` string, required — Name of the file including its extension
- `conflict_behaviour` 'replace' | 'rename' | 'fail', nullable — When a file name conflict is detected, this parameter handles its behaviour

## Response `200`

- object
  - `data` object
    - `id` integer
    - `key` string
    - `name` string
    - `version` string
    - `conflict_behaviour` string
  - `credentials` object
    - `sessionToken` string
    - `accessKeyId` string
    - `secretAccessKey` string
    - `region` string
    - `bucket` string
  - `conflicted_fileable` string, nullable

---

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