Delete Image

Delete a specific image by its ID.

You will need to authenticate to use this API. See authentication.

This action is irreversible. Once an image is deleted, it cannot be recovered.

Request


DELETE https://api.ojo.so/v1/image/:imageId

Path Parameters

Parameter	Type	Description
imageId	string	The unique identifier of the image to delete

To delete up to 50 images at once, see Delete Images.

cURL


curl --request DELETE \
  --url https://api.ojo.so/v1/image/<Replace with image ID> \
  --header 'Authorization: Bearer <your API key>'

Python


import requests
 
url = "https://api.ojo.so/v1/image/<Replace with image ID>"
 
headers = {
"Authorization": "Bearer <your API key>"
}
 
response = requests.request("DELETE", url, headers=headers)
 
print(response.text)

JavaScript


const options = {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer <your API key>'
  }
};
 
fetch('https://api.ojo.so/v1/image/<Replace with image ID>', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

PHP


<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ojo.so/v1/image/<Replace with image ID>",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <your API key>"
],
]);
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}

Go


package main
 
import (
  "fmt"
  "net/http"
  "io/ioutil"
)
 
func main() {
  url := "https://api.ojo.so/v1/image/<Replace with image ID>"
 
  req, _ := http.NewRequest("DELETE", url, nil)
 
  req.Header.Add("Authorization", "Bearer <your API key>")
 
  res, _ := http.DefaultClient.Do(req)
 
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)
 
  fmt.Println(string(body))
}

Java


HttpResponse<String> response = Unirest.delete("https://api.ojo.so/v1/image/<Replace with image ID>")
  .header("Authorization", "Bearer <your API key>")
  .asString();

Response

200

Image successfully deleted.


{
  "deleted": true
}

401

Your API key might be invalid or expired.


{
  "error": true,
  "message": "Unauthorized",
  "status": 401,
  "title": "Unauthorized",
  "detail": "Unauthorized"
}

404

The specified image was not found or has already been deleted.


{
  "error": true,
  "message": "Image not found",
  "status": 404,
  "title": "Not Found",
  "detail": "Image not found"
}

429

You have hit your rate limit. You can view rate limit details here.


{
  "error": true,
  "message": "Render rate limit reached: 60 image and PDF renders per minute",
  "logs": ["Try again in 2 minutes."],
  "code": "rate_limited.render",
  "retryAfter": 120,
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Render rate limit reached: 60 image and PDF renders per minute"
}

500

An unexpected error occurred. Try again later. If the issue persists, please reach out.


{
  "error": true,
  "message": "Internal Server Error",
  "status": 500,
  "title": "Internal Server Error",
  "detail": "Internal Server Error"
}