Serverless
Files

Upload file from URL

Changed on

Creates a new file at the target path by downloading it from the provided URL.

Required permissions: serverless:files:write. Key presets that include them: SERVERLESS, DEPLOY, FULL. See key permissions.

post/serverless/files/file/url/{file}

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/serverless/files/file/url/{file}
  • Auth
    API key in header Authorization

Path parameters

filestring required

Target file path (including filename)

Example:datasets/images/cat.jpg

Request body

urlstring uri required

Publicly accessible URL for the file

Response

Upload initiated

boolean required

Indicates whether the operation was successful

Changes

    • info

      the endpoint scheme security deployApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API