Update file details
patch
https://api.imagekit.io
/v1/files/:fileId/details
Update file details API
In case of an error, you will get an error code along with the error message. On success, you will receive a
200
status code with the file object in JSON-encoded response body.cURL
Node.js
Python
PHP
Java
Ruby
Go
.Net
# The unique fileId of the uploaded file. fileId is returned in response of list files API and upload API.
curl -X PATCH "https://api.imagekit.io/v1/files/:fileId/details" \
-H 'Content-Type: application/json' \
-u your_private_key: -d'
{
"tags": [
"tag1", "tag2"
],
"customCoordinates": "10,10,100,100"
}
'
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.updateFileDetails("file_id", {
tags : ['image_tag'],
customCoordinates : "10,10,100,100"
}, 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/'
)
updated_detail = imagekit.update_file_details(
file_id="file_id",
options=UpdateFileRequestOptions(remove_ai_tags=['remove-ai-tag-1', 'remove-ai-tag-2'],
webhook_url="url",
tags=["tag1", "tag2"], custom_coordinates="10,10,100,100",
custom_metadata={"test": 11})
)
print("Updated detail-", updated_detail, end="\n\n")
# Raw Response
print(updated_detail.response_metadata.raw)
# print that file's id
print(updated_detail.file_id)
use ImageKit\ImageKit;
$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
);
// Update File Details
$updateData = [
"tags" => ["tag1", "tag2"],
"customCoordinates" => "10,10,100,100"
];
$updateFileDetails = $imageKit->updateFileDetails(
$fileId,
$updateData
);
echo("Updated File Details : " . json_encode($updateFileDetails));
FileUpdateRequest fileUpdateRequest =new FileUpdateRequest("file_id");
List<String> tags=new ArrayList<>();
tags.add("tag1");
tags.add("tag2");
fileUpdateRequest.setTags(tags);
fileUpdateRequest.setCustomCoordinates("10,10,100,100");
Result result=ImageKit.getInstance().updateFileDetail(fileUpdateRequest);
imagekitio = ImageKit::ImageKitClient.new("your_private_key", "your_public_key", "your_url_endpoint")
updated_detail = imagekitio.update_file_details(
"file_id",
{
"tags": ["tag1", "tag2"],
"custom_coordinates": "10,10,100,100"
}
)
resp, err := ik.Media.UpdateFile(ctx, "file_id", media.UpdateFileParam{
Tags: []string{"tag1", "tag2"},
CustomCoordinates: "10,10,100,100",
})
var imagekit = new ImageKit({
publicKey : "your_public_api_key",
privateKey : "your_private_api_key",
urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});
FileUpdateRequest updateob = new FileUpdateRequest
{
fileId = "fileId",
};
List<string> updatetags = new List<string>
{
"tag1",
"tag2"
};
updateob.tags = updatetags;
string updatecustomCoordinates = "10,10,100,100";
updateob.customCoordinates = updatecustomCoordinates;
Result updateresp = imagekit.UpdateFileDetail(updateob);
cURL
Node.js
Python
PHP
Java
Ruby
Go
.Net
# The unique fileId of the uploaded file. fileId is returned in response of list files API and upload API.
# Example of using the google-auto-tagging extension
curl -X PATCH "https://api.imagekit.io/v1/files/file_id/details" \
-H 'Content-Type: application/json' \
-u your_private_key: -d'
{
"extensions": [
{
"name": "google-auto-tagging",
"maxTags": 5,
"minConfidence": 95
}
]
}
'
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.updateFileDetails("file_id", {
extensions: [
{
name: "google-auto-tagging",
maxTags: 5,
minConfidence: 95
}
]
}, 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/'
)
updated_detail = imagekit.update_file_details(
file_id="file_id",
options=UpdateFileRequestOptions(extensions = [
{
"name": "google-auto-tagging",
"maxTags": 5,
"minConfidence": 95
}
])
)
print("Updated detail-", updated_detail, end="\n\n")
# Raw Response
print(updated_detail.response_metadata.raw)
# print that file's id
print(updated_detail.file_id)
use ImageKit\ImageKit;
$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
);
// Update File Details
$updateData = [
"extensions" => [
[
"name" => "google-auto-tagging",
"maxTags" => 5,
"minConfidence" => 95
]
]
];
$updateFileDetails = $imageKit->updateFileDetails(
$fileId,
$updateData
);
echo("Updated File Details : " . json_encode($updateFileDetails));
JsonObject extension = new JsonObject();
extension.addProperty("name", "google-auto-tagging");
extension.addProperty("maxTags", 5);
extension.addProperty("minConfidence", 95);
JsonArray extensionArray = new JsonArray();
extensionArray.add(extension);
fileUpdateRequest.setExtensions(extensionArray);
Result result = ImageKit.getInstance().updateFileDetail(fileUpdateRequest);
imagekitio = ImageKitIo::Client.new("your_private_key", "your_public_key", "your_url_endpoint")
updated_detail = imagekitio.update_file_details(
file_id: "file_id", #required
extension: [
{
name: 'google-auto-tagging',
maxTags: 5,
minConfidence: 95
}
]
)
import (
"github.com/imagekit-developer/imagekit-go/extension"
"github.com/imagekit-developer/imagekit-go/api/uploader"
)
const base64Image = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"
resp, err := ik.Uploader.Upload(ctx, base64Image, uploader.UploadParam{
Extensions: []extension.IExtension{
extension.NewAutoTag(extension.GoogleAutoTag, 95, 5),
extension.NewRemoveBg(extension.RemoveBgOption{}),
},
})
var imagekit = new ImageKit({
publicKey : "your_public_api_key",
privateKey : "your_private_api_key",
urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});
FileUpdateRequest updateob = new FileUpdateRequest
{
fileId = "fileId",
};
List<Extension> extModel = new List<Extension>();
BackGroundImage bck = new BackGroundImage
{
name = "remove-bg",
options = new options() { add_shadow = true, semitransparency = false, bg_color = "green" }
};
extModel.Add(bck);
updateob.extensions = extModel;
Result updateresp = imagekit.UpdateFileDetail(updateob);
/*
"success" status for google-auto-tagging extension having
AITags field synchronously populated.
*/
{
"fileId" : "598821f949c0a938d57563bd",
"type": "file",
"name": "file1.jpg",
"filePath": "/images/products/file1.jpg",
"tags": null,
"AITags" [
{
"name": "saree",
"confidence": 96.2837328,
"source": "google-auto-tagging"
},
{
"name": "traditional clothing",
"confidence": 98.3732228,
"source": "google-auto-tagging"
},
{
"name": "women's wear",
"confidence": 97.7233283,
"source": "google-auto-tagging"
},
{
"name": "ethnic",
"confidence": 99.9928828,
"source": "google-auto-tagging"
}
]
"isPrivateFile" : false,
"customCoordinates" : null,
"url": "https://ik.imagekit.io/your_imagekit_id/images/products/file1.jpg",
"thumbnail": "https://ik.imagekit.io/your_imagekit_id/tr:n-media_library_thumbnail/images/products/file1.jpg",
"fileType": "image",
"mime": "image/jpeg",
"width": 100,
"height": 100,
"size": 100,
"hasAlpha": false,
"createdAt": "2019-08-24T06:14:41.313Z",
"updatedAt": "2019-08-24T06:14:41.313Z",
"extensionStatus": {
"google-auto-tagging": "success"
}
}
Last modified 6mo ago