GET STARTED WITH APIs
Overview
ENDPOINTS
Upload File
Digital Asset Management (DAM)
Custom metadata fields
Managing assets
Get file details
get
Update file details
patch
Delete file
delete
Delete multiple files
post
Copy file
post
Move file
post
Rename file
put
List file versions
get
Get file version details
get
Delete file version
delete
Restore file version
put
Add tags (bulk)
post
Remove tags (bulk)
post
Remove AI tags (bulk)
post
List and search assets
get
Managing folders
Caching
File Metadata
Account Management API
get
https://api.imagekit.io
/v1/files/{fileId}/versions

This API returns details of all versions of a file.

Request

fileId
string
required

The unique fileId of the uploaded file. fileId is returned in list and search assets API and upload API.

Auth
API key
:
Parameters
:
Note

Here, you can explore machine-generated code examples. For practical applications, refer to the examples section below, which includes detailed code snippets from the ImageKit SDKs.

curl --request GET \
  --url https://api.imagekit.io/v1/files/fileId/versions \
  --header 'Accept: application/json' \
  --header 'Authorization: Basic 123'

Responses

Array of file version objects.

Body

array of:
fileId
string

Unique identifier of the asset.

type
string

Type of the asset.

Allowed values:
filefile-version
name
string

Name of the asset.

filePath
string

Path of the file. This is the path you would use in the URL to access the file. For example, if the file is at the root of the media library, the path will be /file.jpg. If the file is inside a folder named images, the path will be /images/file.jpg.

tags

An array of tags assigned to the file. Tags are used to search files in the media library.

AITags

An array of tags assigned to the file by auto tagging.

name
string

Name of the tag.

confidence
number

Confidence score of the tag.

source
string

Source of the tag. Possible values are google-auto-tagging and aws-auto-tagging.

versionInfo
object

An object with details of the file version.

id
string

Unique identifier of the file version.

name
string

Name of the file version.

isPrivateFile
boolean

Specifies if the file is private or not.

isPublished
boolean

Specifies if the file is published or not.

customCoordinates

An string with custom coordinates of the file.

url
string

URL of the file.

thumbnail
string

URL of the thumbnail image. This URL is used to access the thumbnail image of the file in the media library.

fileType
string

Type of the file. Possible values are image, non-image.

mime
string

MIME type of the file.

width
number

Width of the file.

height
number

Height of the file.

size
number

Size of the file in bytes.

hasAlpha
boolean

Specifies if the image has an alpha channel.

customMetadata
object

An object with custom metadata for the file.

createdAt
string

Date and time when the file was uploaded. The date and time is in ISO8601 format.

updatedAt
string

Date and time when the file was last updated. The date and time is in ISO8601 format.

1
[
2
  [
3
    {
4
      "fileId": "598821f949c0a938d57563bd",
5
      "type": "file",
6
      "name": "file.jpg",
7
      "filePath": "/images/products/file.jpg",
8
      "tags": [
9
        "t-shirt",
10
        "round-neck",
11
        "sale2019"
12
      ],
13
      "AITags": [
14
        {
15
          "name": "Shirt",
16
          "confidence": 90.12,
17
          "source": "google-auto-tagging"
18
        },
19
        {
20
          "name": "T-shirt",
21
          "confidence": 80.12,
22
          "source": "aws-auto-tagging"
23
        }
24
      ],
25
      "versionInfo": {
26
        "id": "598821f949c0a938d57563bd",
27
        "name": "Version 2"
28
      },
29
      "isPrivateFile": false,
30
      "customCoordinates": null,
31
      "url": "https://ik.imagekit.io/your_imagekit_id/images/products/file.jpg?updatedAt=1566630881313",
32
      "thumbnail": "https://ik.imagekit.io/your_imagekit_id/images/products/file.jpg?updatedAt=1566630881313&tr=n-ik_ml_thumbnail",
33
      "fileType": "image",
34
      "mime": "image/jpeg",
35
      "width": 100,
36
      "height": 100,
37
      "size": 100,
38
      "hasAlpha": false,
39
      "customMetadata": {
40
        "brand": "Nike",
41
        "color": "red"
42
      },
43
      "createdAt": "2019-08-24T06:14:41.313Z",
44
      "updatedAt": "2019-08-24T06:14:41.313Z"
45
    },
46
    {
47
      "fileId": "598821f949c0a938d81963bd",
48
      "type": "file-version",
49
      "name": "file.jpg",
50
      "filePath": "/images/products/file.jpg",
51
      "tags": [
52
        "t-shirt",
53
        "sale2019"
54
      ],
55
      "AITags": [
56
        {
57
          "name": "Shirt",
58
          "confidence": 90.12,
59
          "source": "google-auto-tagging"
60
        },
61
        {
62
          "name": "T-shirt",
63
          "confidence": 80.12,
64
          "source": "aws-auto-tagging"
65
        }
66
      ],
67
      "versionInfo": {
68
        "id": "598821f949c0a938d57563bd",
69
        "name": "Version 1"
70
      },
71
      "isPrivateFile": false,
72
      "customCoordinates": null,
73
      "url": "https://ik.imagekit.io/your_imagekit_id/images/products/file.jpg?ik-obj-version=iAg8gxkqo_QUBwqNeQrJzuyce2XB7Gc4&updatedAt=1566630881313",
74
      "thumbnail": "https://ik.imagekit.io/your_imagekit_id/images/products/file.jpg?ik-obj-version=iAg8gxkqo_QUBwqNeQrJzuyce2XB7Gc4&updatedAt=1566630881313&tr=n-ik_ml_thumbnail",
75
      "fileType": "image",
76
      "mime": "image/jpeg",
77
      "width": 100,
78
      "height": 100,
79
      "size": 100,
80
      "hasAlpha": false,
81
      "customMetadata": {
82
        "brand": "Nike",
83
        "color": "red"
84
      },
85
      "createdAt": "2019-08-24T06:15:41.313Z",
86
      "updatedAt": "2019-08-24T06:15:41.313Z"
87
    }
88
  ]
89
]

Examples

Here is the example request to understand the API usage.

Copy
# The unique fileId of the uploaded file. fileId is returned in response of list files API and upload API.
curl -X GET "https://api.imagekit.io/v1/files/file_id/versions" \
-u your_private_api_key:

var ImageKit = require("imagekit");

var imagekit = new ImageKit({
    publicKey : "your_public_api_key",
    privateKey : "your_private_api_key",
    urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});

imagekit.getFileVersions("file_id", function(error, result) {
    if(error) console.log(error);
    else console.log(result);
});

from imagekitio import ImageKit

imagekit = ImageKit(
    public_key='your_public_api_key',
    private_key='your_private_api_key',
    url_endpoint = 'https://ik.imagekit.io/your_imagekit_id/'
)

file_versions = imagekit.get_file_versions(file_id='file_id')

print("Get File versions-", "\n", file_versions)

# Raw Response
print(file_versions.response_metadata.raw)

# print that file's version id
print(file_versions.list[0].version_info.id)

$public_key = "your_public_api_key";
$your_private_key = "your_private_api_key";
$url_end_point = "https://ik.imagekit.io/your_imagekit_id";

$imageKit = new ImageKit(
    $public_key,
    $your_private_key,
    $url_end_point
);

$fileId = 'file_id';

$getFileVersions = $imageKit->getFileVersions($fileId);

echo("File Versions : " . json_encode($getFileVersions));

String fileId = "file_id";
ResultFileVersions resultFileVersions = ImageKit.getInstance().getFileVersions(fileId);


imagekitio = ImageKitIo::Client.new("your_private_key", "your_public_key", "your_url_endpoint")
imagekitio.file_versions(
    file_id: 'file_id'
)

resp, err := ik.Media.FileVersions(ctx, media.FileVersionsParam{
    FileId: "file_id",
})

var imagekit = new ImageKit({
    publicKey : "your_public_api_key",
    privateKey : "your_private_api_key",
    urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});
ResultFileVersions resultFileVersions = imagekit.GetFileVersions("file_Id");