# Create an External Link

Create an  resource to share with users so they can upload files directly from their browser. For more info, see Uploading files to Finix.

Endpoint: POST /files/{file_id}/external_links
Version: 2022-02-01
Security: BasicAuth

## Path parameters:

  - `file_id` (string, required)
    Your  ID.

## Request fields (application/json):

  - `duration` (integer)
    Set how long (in minutes) the external link is valid for. The link can be valid for up to 10080 minutes (7 days).

  - `tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `type` (string, required)
    Set to UPLOAD to create a link that can be used to upload files to Finix.Set to DOWNLOAD to create a link where the uploaded file can be downloaded from.Set to VIEW to create a link that displays the file in browser.
    Enum: "UPLOAD", "DOWNLOAD", "VIEW"

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the  resource.

  - `created_at` (string)
    Timestamp of when the object was created.

  - `duration` (integer,null)
    Details how long (in minutes) the  is valid for.

  - `expired` (boolean)
    true or false

  - `expires_at` (string)
    When the external link expires

  - `file_id` (string)
    The  ID the  relates to.

  - `tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `type` (string)
    Sets if the link is for uploading or downloading files from Finix.
    Enum: "UPLOAD", "DOWNLOAD", "VIEW"

  - `url` (string)
    The URL that can be used to upload, download, or view the file.

  - `user_id` (string)
    The ID of the  that requested to create this link.

## Response 401 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "UNKNOWN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.self` (object)

  - `_embedded.errors._links.self.href` (string)

  - `_embedded.errors._links.source` (object)

## Response 403 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "FORBIDDEN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 404 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "NOT_FOUND"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 406 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "NOT_FOUND"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)