Updating Assets

Konifer lets you update asset information only. Asset content cannot be updated.

Request

PUT /assets/users/123/-/entry/0
Content-Type: application/json

{
  "alt": "Profile Picture",
  "tags": ["headshot", "team"],
  "labels": {
    "department": "engineering"
  }
}

Field Name	Type	Description	Required
alt	String	The supplied alt text of your asset	No
labels	Object	Supplied key-value pairs associated with the asset	No
tags	Array	Supplied attributes associated with the asset	No

warning

PUT is a complete replacement of the asset's information. Even if updating one field, the rest of the fields must be supplied, or they are erased.

Response

The entire asset information response is returned.

HTTP/1.1 200
Content-Type: application/json

{
  "class": "image",
  "alt": "Profile Picture",
  "entryId": 0,
  "labels": {
    "department": "engineering"
  },
  "tags": ["headshot", "team"],
  "source": "upload",
  "variants": [
  {
      "isOriginalVariant": false,
    "storeBucket": "assets",
    "storeKey": "b5050e94-0b05-471a-ae73-6cede8e077bd.webp",
    "attributes": {
      "height": 1752,
        "width": 2560,
        "format": "webp",
    "pageCount": 1,
    "loop": 0,
        "colorSpace": "srgb"
      },
      "transformation": {
      "width": 2560,
        "height": 1752,
    "fit": "fit",
    "gravity": "center",
    "format": "webp",
    "rotate": "zero",
    "flip": "none",
    "filter": "none",
    "blur": 150,
    "quality": 80,
    "padding": {
      "amount": 0,
      "color": []
    },
    "metadata": {
          "strip": [
            "exif", "xmp", "iptc"
          ],
        }
      },
    "lqip": {}
  },
  {
    "isOriginalVariant": true,
    "storeBucket": "assets",
    "storeKey": "d1caa24e-daba-4398-9fef-68c8b275456b.webp",
    "attributes": {
        "height": 1752,
        "width": 2560,
        "format": "webp",
        "pageCount": 1,
        "loop": 0,
        "colorSpace": "srgb"
      },
      "lqip": {}
    }
  ]
}