Post Api V4 Media Id

Modify asset

POST/api/v4/media/{id}

Use it in a workflow

Add a step and choose the Bynder connector.
Pick the Post Api V4 Media Id action (under Asset Management).
Fill in the fields below, then reference the result from later steps as {{postApiV4MediaId.response.data}}.

Request

Path parameters

idstringrequired

Asset id.

Request body

Enter the body as JSON in the step's Body field.

idstring

Asset id.

namestring

Name of the asset, beware the asset will have no name when this is empty.

descriptionstring

Asset description.

copyrightstring

brandIdstring

Id of the brand to save the asset to.

tagsstring

Comma-separated tags. Tags will overwrite the current tags list.

metapropertyobject

Mapping of metaproperty UUIDs to the option value(s) to set on the asset. Each value may be provided as option label, option DB name, or option UUID. For multi-select metaproperties, pass multiple values as a comma-separated string. <br><br>In x-www-form-urlencoded requests, fields are sent as `metaproperty.<metaproperty_uuid>=<value1>,<value2>`.

datePublishedstring (date-time)

Publication datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

archiveboolean

Indicating the archived state of the asset.

archiveDatestring (date-time)

Archive datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

limitedboolean

Indicating the limit state of the asset.

limitedDatestring (date-time)

Limit datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

watermarkDatestring (date-time)

Watermark datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

isPublicboolean

Indicating the public state of the asset. Warning irreversible, once changed to true it cannot be changed back.

json

{
  "id": "string",
  "name": "string",
  "description": "string",
  "copyright": "string",
  "brandId": "string",
  "tags": "string",
  "metaproperty": {
    "02509778-CEE3-43D5-9E96-9A60B1E78314": "option_id1,option_id2",
    "EF122F1F-9BA0-4772-80F1-BF05588B1A59": "option_id3"
  },
  "datePublished": "2025-01-01T00:00:00Z",
  "archive": false,
  "archiveDate": "2025-01-01T00:00:00Z",
  "limited": false,
  "limitedDate": "2025-01-01T00:00:00Z"
}

Response

Returns 202 with an object. Read it in later steps with {{postApiV4MediaId.response.data.<field>}}.

messagestring

statuscodeinteger

json

{
  "message": "string",
  "statuscode": 0
}

Need more? See the Bynder guide for connection setup and behaviour shared by every action.

Was this page helpful?