Disclaimer: This website requires JavaScript to function properly. Some features may not work as expected. Please enable JavaScript in your browser settings for the best experience.

Dev GuideAPI ReferenceChangelog
Dev GuideAPI ReferenceUser GuideLegal TermsDev CommunityOptimizely AcademySubmit a ticketLog In
API Reference

Library events

asset_added

An asset (article, image, video, raw file, or structured content) was added to the library for reasons including, but not limited to, uploading assets, completing a task, and so on.

Payload

KeyTypeDescription
event_namestringName of the event. The value is asset_added.
dataobjectData of the event.
data[asset]objectData of the asset associated with the event.
data[asset][id]stringUnique identifier of the asset.
data[asset][owner_organization_id]stringOwner organization ID of the asset.
data[asset][type]stringType of the asset. Value can be article, image, video, raw_file, or structured_content.
data[asset][source]objectSource of the asset.
data[asset][source][id]string or nullIdentifier of the source. Sends the ID of a task if the asset is added by completing the task.
data[asset][source][type]string or nullType of the source. Sends task as the value, if the asset is added by completing the task.
data[asset][source][links]objectLinks related to the asset source.
data[asset][source][links][self]string or nullURL to fetch the source details through the CMP Open API. Sends the URL of the task API if the asset is added by completing the task.
data[asset][links]objectLinks related to the asset.
data[asset][links][self]stringURL to fetch the asset's details through the CMP Open API.

Example

{
  "event_name": "asset_added",
  "data": {
    "asset": {
      "id": "019a86405de737b4ec3e616a4aeff981",
      "owner_organization_id": "5108c3a9becac35915111191",
      "type": "image",
      "source": {
          "id": "656893caea057917c5796f2e",
          "type": "task",
          "links": {
            "self": "https://api.cmp.optimizely.com/v3/tasks/656893caea057917c5796f2e"
          }
      },
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/images/019a86405de737b4ec3e616a4aeff981"
      }
    }
  }
}

asset_removed

An asset (article, image, video, raw file, or structured content) was removed from the library for reasons including, but not limited to, deleting assets.

Payload

KeyTypeDescription
event_namestringName of the event. The value is asset_removed.
dataobjectData of the event.
data[asset]objectData of the asset associated with the event.
data[asset][id]stringUnique identifier of the asset.
data[asset][owner_organization_id]stringOwner organization ID of the asset.
data[asset][type]stringType of the asset. Value can be article, image, video, raw_file, or structured_content.

Example

{
  "event_name": "asset_removed",
  "data": {
    "asset": {
      "id": "870825113a12950a7eeeb64a64236d49",
      "owner_organization_id": "5108c3a9becac35915111191",
      "type": "article"
    }
  }
}

asset_modified

An asset (article, image, video, raw file, or structured content) was modified in the library.

The event is triggered when specific attributes of a file type change, as listed below.

  • article – title, labels, file location, expires_at, tags, owner_id, url, is_archived
  • image & video – title, description, labels, file location, versions, alt_text, expires_at, tags, attribution_text, owner_id, url, is_archived
  • raw file – title, description, labels, file location, versions, expires_at, tags, attribution_text, owner_id, url, is_archived
  • structured content – file location, tags, owner_id, is_archived

Payload

KeyTypeDescription
event_namestringName of the event. The value is asset_modified.
dataobjectData of the event.
data[asset]objectData of the asset associated with the event.
data[asset][id]stringUnique identifier of the asset.
data[asset][owner_organization_id]stringOwner organization ID of the asset.
data[asset][type]stringType of the asset. Value can be article, image, video, raw_file, or structured_content.
data[asset][source]objectSource of the asset.
data[asset][source][id]string or nullIdentifier of the source. Sends the ID of a task if the asset is modified by completing the task.
data[asset][source][type]string or nullType of the source. Sends task as the value, if the asset is modified by completing the task.
data[asset][source][links]objectLinks related to the asset source.
data[asset][source][links][self]string or nullURL to fetch the source details through the CMP Open API. Sends the URL of the task API if the asset is added by completing the task.
data[asset][links]objectLinks related to the asset.
data[asset][links][self]stringURL to fetch the asset's details through the CMP Open API.
data[attributes_changed]arrayList of attributes that trigger the webhook

Example

{
  "event_name": "asset_modified",
  "data": {
    "asset": {
      "id": "019a86405de737b4ec3e616a4aeff951",
      "owner_organization_id": "5108c3a9becac35915111191",
      "type": "image",
      "source": {
          "id": "656893caea057917c5796f2e",
          "type": "task",
          "links": {
            "self": "https://api.cmp.optimizely.com/v3/tasks/656893caea057917c5796f2e"
          }
      },
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/images/019a86405de737b4ec3e616a4aeff951"
      }
    },
    "attributes_changed": ["title", "description", "expires_at"]
  }
}

asset_renditions_created

An asset's renditions are created.

Payload

KeyTypeDescription
event_namestringName of the event. The value is asset_renditions_created.
dataobjectData of the event.
data[asset]objectData of the asset associated with the event.
data[asset][id]stringUnique identifier of the asset.
data[asset][owner_organization_id]stringOwner organization ID of the asset.
data[asset][type]stringType of the asset.
data[asset][links]objectLinks related to the asset.
data[asset][links][self]stringURL to fetch the asset's details through the CMP Open API.
data[asset][links][renditions]stringURL to fetch the asset's renditions through the CMP Open API.

Example

{
  "event_name": "asset_renditions_created",
  "data": {
    "asset": {
      "id": "019a86405de737b4ec3e616a4aeff951",
      "owner_organization_id": "5108c3a9becac35915111191",
      "type": "image",
      "links": {
        "self": "https://api.cmp.optimizely.com/v3/images/019a86405de737b4ec3e616a4aeff951",
        "renditions": "https://api.cmp.optimizely.com/v3/assets/019a86405de737b4ec3e616a4aeff951/renditions"
      }
    }
  }
}