Skip to main content
The file upload process consists of two main steps:
  • Obtain a signed URL for upload
  • Upload your file using the signed URL

​
Getting a signed url

Send a POST request to the following endpoint: 
https://api.turbofiles.io/v1/files
Your request must include the following fields:
  • format: The file’s MIME type
  • size: The file size in bytes

​
Uploading Your File

Once you receive the response, locate the signed URL in data.links.upload. Use this URL to upload your file by sending a PUT request. Make sure the file size matches the size you specified when requesting the signed URL.

​
File Lifecycle

Uploaded files are automatically deleted after 48 hours. During this period, you can use the files to trigger various tasks. 
POST /files HTTP/1.1
Accept: application/vnd.api+json
Content-Type: application/vnd.api+json

{
  "data": {
    "type": "files",
    "attributes": {
      "format": "image/png",
      "size": 504233
    }
  }
}

{
  "jsonapi": {
    "version": "1.1"
  },
  "data": {
    "type": "files",
    "id": "8fhd83jpk",
    "attributes": {
      "format": "image/png",
      "size": 504233,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "links": {
      "self": "<string>",
      "upload": "<string>",
      "download": "<string>"
    }
  },
  "links": {
    "self": "<string>"
  }
}