album.update

bearer

Rename/re-describe a folder

Partial update: omitted fields are left unchanged. The default folder is immutable.

Parameters

Passed by name in the params object.

Name Type Required Description
id string yes Folder UUID
name string no New name; omit to leave unchanged
description string no New description; omit to leave unchanged

Result

Returns albumDTO:

Field Type Description
created_at * string
description * string
id * string
image_count * integer
is_default * boolean
name * string
visibility * string

Errors

Code Message When
2001 not_found No such resource owned by the caller.
1003 forbidden Not the owner, or outside a token's scope.

See the error reference for the full catalog, including the authentication codes.

Example

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "album.update",
  "params": {
    "id": "018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50",
    "name": "Iceland — spring 2024"
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50",
    "name": "Iceland 2024",
    "description": "Ring road, March.",
    "is_default": false,
    "visibility": "private",
    "image_count": 42,
    "created_at": "2026-02-11T07:03:00Z"
  }
}

curl

curl -s https://peinture.gumeniuk.com/rpc \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"album.update","params":{"id":"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50","name":"Iceland — spring 2024"}}'

JavaScript

const res = await fetch("https://peinture.gumeniuk.com/rpc", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${token}`,
  },
  body: JSON.stringify({
    jsonrpc: "2.0", id: 1, method: "album.update", params: {"id":"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50","name":"Iceland — spring 2024"},
  }),
});
const { result, error } = await res.json();

Go

body := []byte(`{"jsonrpc":"2.0","id":1,"method":"album.update","params":{"id":"018f3a80-1c2d-7e00-9a00-0b1c2d3e4f50","name":"Iceland — spring 2024"}}`)
req, _ := http.NewRequest("POST", "https://peinture.gumeniuk.com/rpc", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer "+token)
resp, err := http.DefaultClient.Do(req)

Try it

Sends a real request to /rpc from your browser. Paste a bearer token above — a JWT access token or a personal access token (pnt_…).