file.io API
 1.0.0 
OAS3

file.io API

Servers
Authorize

default

Creates a file

Parameters

Try it out

No parameters

Request body

file
string($binary)
expires
maxDownloads
integer
autoDelete
boolean

Responses

CodeDescriptionLinks
200

A FileDetails object

Media type
Controls Accept header.
{
  "success": true,
  "status": 0,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "key": "string",
  "name": "string",
  "link": "string",
  "expires": "2025-01-06T15:37:03.357Z",
  "expiry": "string",
  "downloads": 0,
  "maxDownloads": 0,
  "autoDelete": true,
  "size": 0,
  "mimeType": "string",
  "created": "2025-01-06T15:37:03.357Z",
  "modified": "2025-01-06T15:37:03.357Z"
}
No links

Gets list of files

Parameters

Try it out
NameDescription
search
string
(query)
sort
string
(query)
offset
integer
(query)
limit
integer
(query)

Responses

CodeDescriptionLinks
200

An array of FileDetails objects

Media type
Controls Accept header.
{
  "count": 0,
  "files": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "key": "string",
      "name": "string",
      "link": "string",
      "expires": "2025-01-06T15:37:03.359Z",
      "expiry": "string",
      "downloads": 0,
      "maxDownloads": 0,
      "autoDelete": true,
      "size": 0,
      "mimeType": "string",
      "created": "2025-01-06T15:37:03.359Z",
      "modified": "2025-01-06T15:37:03.359Z"
    }
  ]
}
No links

Downloads the file identified by {key}

Parameters

Try it out
NameDescription
key *
string
(path)

Responses

CodeDescriptionLinks
200

File data

Media type
Controls Accept header.
string
No links
302

Redirect to https://www.file.io/download/{key}

No links

Updates the file identified by {key}. Any parameters not provided are reset to defaults.

Parameters

Try it out
NameDescription
key *
string
(path)

Request body

file
string($binary)
expires
maxDownloads
integer
autoDelete
boolean

Responses

CodeDescriptionLinks
200

A FileDetails object

Media type
Controls Accept header.
{
  "success": true,
  "status": 0,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "key": "string",
  "name": "string",
  "link": "string",
  "expires": "2025-01-06T15:37:03.361Z",
  "expiry": "string",
  "downloads": 0,
  "maxDownloads": 0,
  "autoDelete": true,
  "size": 0,
  "mimeType": "string",
  "created": "2025-01-06T15:37:03.361Z",
  "modified": "2025-01-06T15:37:03.361Z"
}
No links

Updates the file identified by {key}. For any parameters not provided in request, existing values are retained.

Parameters

Try it out
NameDescription
key *
string
(path)

Request body

file
string($binary)
expires
maxDownloads
integer
autoDelete
boolean

Responses

CodeDescriptionLinks
200

A FileDetails object

Media type
Controls Accept header.
{
  "success": true,
  "status": 0,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "key": "string",
  "name": "string",
  "link": "string",
  "expires": "2025-01-06T15:37:03.363Z",
  "expiry": "string",
  "downloads": 0,
  "maxDownloads": 0,
  "autoDelete": true,
  "size": 0,
  "mimeType": "string",
  "created": "2025-01-06T15:37:03.363Z",
  "modified": "2025-01-06T15:37:03.363Z"
}
No links

Deletes the file identified by

Parameters

Try it out
NameDescription
key *
string
(path)

Responses

CodeDescriptionLinks
200

Response

Media type
Controls Accept header.
{
  "success": true,
  "status": 0
}
No links

Gets plan/account details for authenticated user

Parameters

Try it out

No parameters

Responses

CodeDescriptionLinks
200

Plan/account details

Media type
Controls Accept header.
{
  "success": true,
  "status": 0,
  "planId": 0,
  "maxUploadBytes": 0,
  "maxStorageBytes": 0,
  "usedStorageBytes": 0,
  "rateLimit": 0
}
No links

{
success
status
}
string
pattern: ^[1-9]\d*[y|Q|M|w|d|h|m|s]$
{
id
key
name
link
expires
expiry
downloads
maxDownloads
autoDelete
size
mimeType
created
modified
}
{
success
status
id
key
name
link
expires
expiry
downloads
maxDownloads
autoDelete
size
mimeType
created
modified
}