---
title: "Upload or finalize file"
method: POST
path: "/api/2/upload/{fileable}"
tags: ["Upload"]
---

# Upload or finalize file

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

Processes a file upload via direct transfer or S3 finalization.

 **STRATEGY 1**: Direct Upload (Files < 25 MB)

 <ul>
 <li>Action: Pass the binary content in the `file` parameter.</li>
</ul>

 **STRATEGY 2**: S3 Session Upload (Files > 25 MB)

<ul>
<li>Action: Finalize a large file previously uploaded to S3</li>
<li>Requirement: You must provide the `version` string obtained during the 'Request file upload' step</li>
</ul>

S3 Workflow Reference:
<ol>
<li>Call 'Request file upload' (returns credentials, `key`, and `version`)</li>
<li>Upload to S3 using the AWS SDK</li>
<li>Call this endpoint with the `version` string to create the file record</li>
</ol>

## Response `200`

- object
  - `Id` integer
  - `@type` string
  - `@id` string
  - `Access` string
  - `Link` string
  - `OriginalLink` string
  - `URL` string
  - `created_at` string
  - `deleted_at` string, nullable
  - `expires_at` string, nullable
  - `updated_at` string
  - `creator` object
    - `ID` integer
    - `@type` string
    - `Title` string, nullable
    - `Name` string
    - `FirstName` string
    - `LastName` string
    - `Avatar` string
    - `Scope` string
    - `HasContact` boolean
  - `Scope` string
  - `Editable` boolean
  - `RestrictDownloads` boolean
  - `current` object
    - `Id` integer
    - `Name` string
    - `Size` integer
    - `Source` string
    - `ExternalLink` string, nullable
    - `MimeType` string
    - `Stored` boolean
    - `AVStatus` string, nullable
    - `created_at` string
    - `Thumbnail` string, nullable
    - `@type` string
    - `updated_at` string
    - `deleted_at` 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)