AIaircaps
Files

Create an upload URL

Get a presigned URL to upload a file of up to 5 GB straight to storage. PUT the raw bytes to upload_url within an hour, then use id as file_id.

post/v1/files/upload-url

Request

  • Base URL
    https://api.aircaps.com
  • URL
    https://api.aircaps.com/v1/files/upload-url
  • Auth
    HTTP bearer

Response

Upload URL created.

idstring required

Use as file_id after the upload.

object'file' required
upload_urlstring required

Presigned URL: PUT the raw file bytes here.

method'PUT' required
upload_expires_atstring date-time required

Upload before this (one hour).

expires_atstring date-time required

Usable until this time (24 hours after upload); the file is deleted within the following 24 hours, or right away when a transcript that used it is deleted.

max_size_bytesinteger required

Example response

{
  "id": "file_01k6z3m4q8w7e5r2t1y0u9i8o7",
  "max_size_bytes": 5368709120
}

Changes

No recorded changes to this operation across all 1 revision of this API.