---
title: "File Upload to S3"
method: POST
path: "/v2/applicants/{id}/secure_documents/upload"
tags: ["Applicants"]
---

# File Upload to S3

`POST /v2/applicants/{id}/secure_documents/upload`

Step 1 of 2 for adding files to an applicant profile.

## Path parameters

- `id` string, required

## Request body

- object
  - `filename` string — path/to/file.upload

## Response `200`

OK

- ApplicantSecureDocumentUploadResponse
  - `url` string, uri, required — The URL to upload the file to.
  - `host` string, required — The HOST of the URL.
  - `min_size` number, required — Minimum file upload size.
  - `max_size` number, required — Maximum file upload size.
  - `only_images` boolean, required — TRUE if only for uploading images.
  - `type` string — HTTP verb to upload file.
  - `form_data` object, required
    - `key` string, required — Path of the filename to be uploaded.
    - `success_action_status` string, required — HTTP code if upload is successful.
    - `acl` string, required — Network Access Control List
    - `x-amz-server-side-encryption-customer-algorithm` string, required
    - `x-amz-server-side-encryption-customer-key` string, required
    - `x-amz-server-side-encryption-customer-key-MD5` string, required
    - `policy` string, required
    - `x-amz-credential` string, required
    - `x-amz-algorithm` string, required
    - `x-amz-date` string, required
    - `x-amz-signature` string, required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)