Create or Update Asset Filter

Put https://app.mk.io/api/v1/projects/:project_name/media/assets/:asset_name/assetFilters/:filter_name

Create or Update Asset Filter.

RBAC Capability Required: ams.assetfilter.create or ams.assetfilter.update

Authentication

Authorization Bearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

• project_name (string, Required)
• asset_name (string, Required)
• filter_name (string, Required)

Request

This endpoint expects an object.

Properties

• properties (object) [MediaFilterProperties] Required
  Properties for the asset filter

• firstQuality (object) [FirstQuality] Optional
  This parameter defines the initial quality level when playback starts. This is the first bitrate in the ladder.

• bitrate (integer, Required)
  Denotes the target video bitrate to be used when starting playback of an HLS manifest.

• presentationTimeRange (object) [PresentationTimeRange] Optional
  This parameter is used to cut an asset into a smaller asset by specifying a start and end time.

  • endTime (string, Optional) format: date-time
  • endTimestamp (integer, Optional) >= 0
  • forceEndTimestamp (boolean, Optional)
  • liveBackoffDuration (integer, Optional)
  • presentationWindowDuration (integer, Optional)
  • startTime (string, Optional) format: date-time
  • startTimestamp (integer, Optional) >= 0
  • timescale (integer, Optional) 1 to 1000000000 Defaults to 10000000

• tracks (list of objects) [FilterTrackSelection] Optional
  Defines the tracks to include in the output.

  • trackSelections (list of objects) [FilterTrackPropertyCondition] Required
    Defines the tracks to include in the output.

    [{
        "property": "Type",
        "operation": "Equal",
        "value": "Audio"
    },
    {
        "property": "Bitrate",
        "operation": "Equal",
        "value": "3000000-5000000"
    },
    {
        "property": "Language",
        "operation": "NotEqual",
        "value": "en"
    }]
    

Response

200

Asset Filter was updated

• id (string, Optional)
  Fully qualified resource ID for the resource.
• name (string, Optional)
  The name of the resource.
• properties (object) [MediaFilterProperties] Required

Errors

• 400 Bad Request

  • error (object) [ErrorDetail] Required

• 401 Unauthorized

  • error (object) [ErrorDetail] Required

• 403 Forbidden

  • error (object) [ErrorDetail] Required

• 404 Not Found

  • error (object) [ErrorDetail] Required

• 429 Too Many Requests

  • error (object) [ErrorDetail] Required

• 500 Internal Server Error

  • error (object) [ErrorDetail] Required