{ "info": { "name": "peinture API", "description": "Image storage \u0026 processing. Metadata and control is JSON-RPC 2.0 over POST /rpc; raw bytes (upload, archive, image serving) are plain HTTP.\n\nSet the `token` variable to a personal access token (pnt_…) or a JWT access token from auth.login.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "account", "item": [ { "name": "account.setEmail", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"account.setEmail\",\n \"params\": {\n \"current_password\": \"correct-horse-battery-staple\",\n \"email\": \"ada@analyticalengine.example\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Change the caller's email address" } }, { "name": "account.setPassword", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"account.setPassword\",\n \"params\": {\n \"current_password\": \"correct-horse-battery-staple\",\n \"new_password\": \"Tr0ub4dour\\u00263-fresh\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Change the caller's password" } } ] }, { "name": "album", "item": [ { "name": "album.create", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.create\",\n \"params\": {\n \"name\": \"Iceland 2024\",\n \"description\": \"Ring road, March.\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Create a folder" } }, { "name": "album.crop.delete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.crop.delete\",\n \"params\": {\n \"album_id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\",\n \"code\": \"hero\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Delete a folder crop rule (re-renders the folder)" } }, { "name": "album.crop.list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.crop.list\",\n \"params\": {\n \"album_id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "List a folder's crop rules" } }, { "name": "album.crop.set", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.crop.set\",\n \"params\": {\n \"album_id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\",\n \"code\": \"hero\",\n \"width\": 1200,\n \"height\": 630,\n \"mode\": \"fill\",\n \"format\": \"webp\",\n \"quality\": 82\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Add or update a folder crop rule (re-renders the folder)" } }, { "name": "album.delete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.delete\",\n \"params\": {\n \"id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Delete a folder" } }, { "name": "album.list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.list\",\n \"params\": {}\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "List the caller's folders (default first)" } }, { "name": "album.move", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.move\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"album_id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Move a photo into a folder" } }, { "name": "album.reorder", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.reorder\",\n \"params\": {\n \"album_id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\",\n \"ordered_ids\": [\n \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1e\"\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Set the manual order of photos within a folder" } }, { "name": "album.update", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"album.update\",\n \"params\": {\n \"id\": \"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50\",\n \"name\": \"Iceland — spring 2024\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Rename/re-describe a folder" } } ] }, { "name": "auth", "item": [ { "name": "auth.login", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"auth.login\",\n \"params\": {\n \"email\": \"ada.lovelace@example.com\",\n \"password\": \"correct-horse-battery-staple\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Log in with email and password" } }, { "name": "auth.logoutAll", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"auth.logoutAll\",\n \"params\": {}\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Revoke all of the caller's sessions" } }, { "name": "auth.refresh", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"auth.refresh\",\n \"params\": {\n \"refresh_token\": \"eyJhbGciOiJIUzI1NiJ9.eyJ0eXAiOiJyZWZyZXNoIn0.Zm9vYmFy\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Exchange a refresh token for a new token pair" } } ] }, { "name": "image", "item": [ { "name": "image.archiveToken", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.archiveToken\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Mint a short-lived link to download the full archive" } }, { "name": "image.crop.add", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.crop.add\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"code\": \"square\",\n \"width\": 1080,\n \"height\": 1080,\n \"mode\": \"fill\",\n \"format\": \"webp\",\n \"quality\": 82\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Add a custom crop (max 5 per image)" } }, { "name": "image.crop.delete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.crop.delete\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"code\": \"square\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Delete a custom crop by code" } }, { "name": "image.delete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.delete\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Delete an image" } }, { "name": "image.exif.setVisibility", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.exif.setVisibility\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"groups\": {\n \"gps\": false,\n \"camera\": true\n }\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Toggle which EXIF groups are exposed publicly" } }, { "name": "image.get", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.get\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Get one of the caller's images with full detail" } }, { "name": "image.getPublic", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.getPublic\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Get a ready image's public view (no authentication)" } }, { "name": "image.list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.list\",\n \"params\": {\n \"limit\": 50\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "List the caller's images (cursor-paginated)" } }, { "name": "image.regenerate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.regenerate\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Re-render all sizes for an image" } }, { "name": "image.update", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"image.update\",\n \"params\": {\n \"id\": \"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d\",\n \"title\": \"Golden Gate at first light\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Update an image's title and/or description" } } ] }, { "name": "rpc", "item": [ { "name": "rpc.discover", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"rpc.discover\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Return the OpenRPC document describing this API" } } ] }, { "name": "token", "item": [ { "name": "token.create", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"token.create\",\n \"params\": {\n \"current_password\": \"correct-horse-battery-staple\",\n \"name\": \"backup-script\",\n \"expires_at\": \"2027-01-01T00:00:00Z\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Create a personal access token" } }, { "name": "token.list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"token.list\",\n \"params\": {}\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "List the caller's personal access tokens" } }, { "name": "token.revoke", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"token.revoke\",\n \"params\": {\n \"id\": \"018f3a8e-3c9d-7a2b-b5e6-7f8a9b0c1d2e\"\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rpc", "host": [ "{{baseUrl}}" ], "path": [ "rpc" ] }, "description": "Revoke a personal access token" } } ] } ], "variable": [ { "key": "baseUrl", "value": "https://peinture.gumeniuk.com", "type": "string" }, { "key": "token", "value": "", "type": "string" } ] }