---
title: "Create a File Link"
method: POST
path: "/file_links"
---

# Create a File Link

`POST /file_links`

## Request body

- CreateAFileLinkParameters
  - `expires_at` string, date-time — The time at which the File Link will expire. The default is 1 hour from the time of the request. The maximum is 1 day from the time of the request.
  - `file_id` string, required — The File to create a File Link for.

## Response `200`

File Link

- FileLink — File Links let you generate a URL that can be used to download a File.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the File Link was created.
  - `expires_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the File Link will expire.
  - `file_id` string, required — The identifier of the File the File Link points to.
  - `id` string, required — The File Link identifier.
  - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
  - `type` 'file_link', required — A constant representing the object's type. For this resource it will always be `file_link`.
  - `unauthenticated_url` string, required — A URL where the File can be downloaded. The URL will expire after the `expires_at` time. This URL is unauthenticated and can be used to download the File without an Increase API key.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)