Skip to main content
POST
https://api.imperial.gay
/
images
/
bulk-metadata
Bulk Update Metadata
curl --request POST \
  --url https://api.imperial.gay/images/bulk-metadata \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ],
  "folderId": {},
  "tags": [
    "<string>"
  ],
  "mode": "<string>"
}
'
{
  "updated": 123
}

​
Request

​
Headers

​
Authorization
string
required
Your API key in the format: Bearer imperial_live_xxxxxxxxxxxxx

​
Body

​
ids
string[]
required
Array of upload IDs to update
​
folderId
string|null
Destination folder ID. Use null to move items to Root.
​
tags
string[]
Tags to apply (normalized to lowercase)
​
mode
string
default:"replace"
Tag mode: replace, add, or remove

​
Response

​
updated
number
Number of uploads updated

​
Example

curl -X POST "https://api.imperial.gay/images/bulk-metadata" \
  -H "Authorization: Bearer imperial_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["6987cd047baba11ee0f66d98"],
    "folderId": "6985a036b35713a65e17ccbd",
    "tags": ["work", "2026"],
    "mode": "add"
  }'