Content: Media (internal)

Update selected fields of _media object

Allows update of the Media (internal) object, but it is unnecessary to specify all the object's properties. Properties not included in the payload will be completed with data from the database. <br />

patch/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
sizenumber
typestring
titlestring
widthnumber
heightnumber
sourcestring
fileNamestring
mimeTypestring
extensionstring
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,
  "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
  }
}

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.