---
title: "Upload one or two files from a publicly accessible URL to our object storage. The combined file must not exceed 15MB."
method: POST
path: "/api/servicemedia/processes/files/{storageFolder}/url/upload"
tags: ["storedFiles"]
---

# Upload one or two files from a publicly accessible URL to our object storage. The combined file must not exceed 15MB.

`POST /api/servicemedia/processes/files/{storageFolder}/url/upload`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicemedia/processes/files/{storageFolder}/url/upload`
- Auth: HTTP bearer

## Path parameters

- `storageFolder` string, required

## Request body

- object: Urls to download and reupload the files from
  - `fileUrl` string, required
  - `fileUrlBack` string: Optional back of the uploaded file to try and concatenate in a single uploaded file. Only available for image formats (jpg or png).
  - `workerUuid` string, uuid: Only needed when using a worker-related file storage option

## Response `200`

The created storedFile db document

- object
  - `data` object
    - `uuid` string, uuid
    - `createdAt` string, date-time
    - `createdBy` string, uuid
    - `lastUpdatedAt` string, date-time
    - `lastUpdatedBy` string, uuid
    - `lastUpdatedByAudience` string
    - `lastUpdatedByAudienceUuid` string, uuid
    - `lastUpdatedByImpersonatedBy` string, uuid
    - `lastUpdatedByCompanyUuid` string, uuid
    - `lastUpdatedByEnterpriseUuid` string, uuid
    - `name` string, required
    - `technicalName` string
    - `storageFolder` 'edm' | 'attachments' | 'workers' | 'documentSigning' | 'tmp' | 'publicImages' | 'customScripts' | 'csvImports' | 'complianceImports'
    - `location` object
      - `bucket` string
      - `key` string
    - `companyUuid` string, uuid, required: Owning company. The NIL uuid marks an enterprise-level file, owned by `enterpriseUuid` instead.
    - `enterpriseUuid` string, uuid: Owning enterprise. Only set when `companyUuid` is the NIL uuid.
    - `folderUuid` string, uuid
    - `metadata` object, required
      - `size` number, required
      - `mimeType` string, required
      - `type` 'audio' | 'image' | 'video' | 'text' | 'application', required
      - `extension` string
    - `technical` boolean
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `404`: default error response

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)