Content: Media (internal)

Update existing _media object

Allows update of the Media (internal) object, it has to have all fields, as this operation overwrites the object. All properties not included in the payload will be lost. <br />

put/api/v1/content/_media/{id}

Request

  • Base URL: https://api.flotiq.com
  • URL: https://api.flotiq.com/api/v1/content/_media/{id}
  • Auth: API key in header X-AUTH-TOKEN

Path parameters

idstring required

ContentObject identifier

Request body

idstring required

Unique ID of the object

altstring
urlstring required
sizenumber required
typestring required
titlestring
widthnumber
heightnumber
sourcestring required
fileNamestring required
mimeTypestring required
extensionstring required
externalIdstring

Example request

{
  "id": "_media-698d20aa-193a-47b3-be4d-550c1aab47e7",
  "extension": "png",
  "fileName": "example_image.png",
  "mimeType": "image/png",
  "size": 87258,
  "type": "image",
  "source": "disk",
  "tags": [
    {
      "dataUrl": "/api/v1/content/_tag/_tag-641775",
      "type": "internal"
    }
  ],
  "variants": [
    {
      "name": "square",
      "trim": {
        "top": 10,
        "right": 10,
        "bottom": 10,
        "left": 10,
        "width": 10,
        "height": 10
      }
    }
  ],
  "externalId": "",
  "url": "/image/0x0/_media-698d20aa-193a-47b3-be4d-550c1aab47e7.png",
  "height": 517,
  "width": 925
}

Response

OK

idstring required

Unique ID of the object

altstring
urlstring required
sizenumber required
typestring required
titlestring
widthnumber
heightnumber
sourcestring required
fileNamestring required
mimeTypestring required
extensionstring required
externalIdstring

Example response

{
  "id": "_media-698d20aa-193a-47b3-be4d-550c1aab47e7",
  "extension": "png",
  "fileName": "example_image.png",
  "mimeType": "image/png",
  "size": 87258,
  "type": "image",
  "source": "disk",
  "tags": [
    {
      "dataUrl": "/api/v1/content/_tag/_tag-641775",
      "type": "internal"
    }
  ],
  "variants": [
    {
      "name": "square",
      "trim": {
        "top": 10,
        "right": 10,
        "bottom": 10,
        "left": 10,
        "width": 10,
        "height": 10
      }
    }
  ],
  "externalId": "",
  "url": "/image/0x0/_media-698d20aa-193a-47b3-be4d-550c1aab47e7.png",
  "height": 517,
  "width": 925,
  "internal": {
    "contentType": "_media",
    "createdAt": "2025-02-06T10:24:27+00:00",
    "updatedAt": "2025-02-06T10:24:27+00:00",
    "deletedAt": "",
    "workflowState": "saved",
    "objectTitle": "example_image.png",
    "latestVersion": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.