Update subscription

PATCH

integration

subscriptions

{subscription_id}

curl --request PATCH \
  --url https://api.mottostreaming.com/integration/subscriptions/v1/{subscription_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "subscription_id": "<string>",
  "subscription": {
    "project_id": "<string>",
    "name": "<string>",
    "topic_id": "<string>",
    "filter": "<string>",
    "https_url": "<string>",
    "delete_after_use": true
  },
  "update_mask": "<string>"
}'

{
  "subscription": {
    "id": "<string>",
    "project_id": "<string>",
    "name": "<string>",
    "topic_id": "<string>",
    "filter": "<string>",
    "https_url": "<string>",
    "delete_after_use": true
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

subscription_id

string

required

Body

application/json

subscription_id

string

required

subscription

object

required

Subscription is used to define which events of the relevant topics should be sent to the callback URL. Limitations:

This is only forward-looking, meaning that only events that occur after the subscription is created will be sent to the target.
There may only be two (2) subscriptions per topic, unless the subscription filter specifies a specific id field OR delete_after_use is set to true.
Delivery is not guaranteed; message delivery will be retried when encountering a non-2xx response, but if there are multiple subscriptions for the same topic and one subscription successfully received the message, it will not be redelivered to the others.

subscription.project_id

string

required

subscription.name

string

required

Name of the subscription. This is used for easy, human readable identification of the subscription.

subscription.topic_id

string

required

The topic that updates should be sent for.

subscription.https_url

string

required

URL to which the events should be sent.

subscription.filter

string

Filter the updates using a subset of the Kibana Query Language. The field names that you use in your filter must exactly match the field names on the object that you are filtering. There are some limitations to the filters that you can use:

Filters can only be on top-level fields that are included in the filterable_fields property of the topic.
Filters cannot be on fields that are an array or dictionary.
Filters only support AND clauses (not OR).

If you do not provide any filter, all updates on the topic will be sent to the target.

Some examples:

If you are interested in all updates on an asset with id of 1234, you can use id:1234.
If you are interested in all updates on an asset with id of 1234 and type of ASSET_TYPE_VIDEO (which is an enum), you can use id:1234 AND type:ASSET_TYPE_VIDEO.
If you are interested in all updates on an entity with type team and name of Barcelona, you can use type:team AND name:Barcelona.
If you are interested in all updates where a field value is after a certain date or time, you can use field_name>"2006-01-02 15:04:05" (in that specific format, specified in UTC).

If a filter cannot be parsed or is invalid, the subscription may still pass initial validation but will then be ignored at run-time, meaning you will not receive any updates as they come through. Be sure to test your filters before relying on them in a production environment.

subscription.delete_after_use

boolean

If true, the subscription will be deleted after the first use. This is useful for cases where the the callback is meant to update the state change of a single resource, e.g. to continue a workflow when a dependent resource is ready.

update_mask

string

required

Response

200

application/json

subscription

object

Subscription is used to define which events of the relevant topics should be sent to the callback URL. Limitations:

This is only forward-looking, meaning that only events that occur after the subscription is created will be sent to the target.
There may only be two (2) subscriptions per topic, unless the subscription filter specifies a specific id field OR delete_after_use is set to true.
Delivery is not guaranteed; message delivery will be retried when encountering a non-2xx response, but if there are multiple subscriptions for the same topic and one subscription successfully received the message, it will not be redelivered to the others.

subscription.project_id

string

required

subscription.name

string

required

Name of the subscription. This is used for easy, human readable identification of the subscription.

subscription.topic_id

string

required

The topic that updates should be sent for.

subscription.https_url

string

required

URL to which the events should be sent.

subscription.id

string

System generated identifier for the platform.

subscription.filter

string

Filters can only be on top-level fields that are included in the filterable_fields property of the topic.
Filters cannot be on fields that are an array or dictionary.
Filters only support AND clauses (not OR).

If you do not provide any filter, all updates on the topic will be sent to the target.

Some examples:

If you are interested in all updates on an asset with id of 1234, you can use id:1234.
If you are interested in all updates on an asset with id of 1234 and type of ASSET_TYPE_VIDEO (which is an enum), you can use id:1234 AND type:ASSET_TYPE_VIDEO.
If you are interested in all updates on an entity with type team and name of Barcelona, you can use type:team AND name:Barcelona.
If you are interested in all updates where a field value is after a certain date or time, you can use field_name>"2006-01-02 15:04:05" (in that specific format, specified in UTC).

subscription.delete_after_use

boolean

List subscriptions Get activity

curl --request PATCH \
  --url https://api.mottostreaming.com/integration/subscriptions/v1/{subscription_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "subscription_id": "<string>",
  "subscription": {
    "project_id": "<string>",
    "name": "<string>",
    "topic_id": "<string>",
    "filter": "<string>",
    "https_url": "<string>",
    "delete_after_use": true
  },
  "update_mask": "<string>"
}'

{
  "subscription": {
    "id": "<string>",
    "project_id": "<string>",
    "name": "<string>",
    "topic_id": "<string>",
    "filter": "<string>",
    "https_url": "<string>",
    "delete_after_use": true
  }
}

Get Started

Studio API

Content Delivery API

Deep dive

Update subscription

Authorizations

Path Parameters

Body

Response