# Webhooks Introduction What is a webhook? A webhook is an HTTP request, triggered by an event in a source system (Tenovos) and sent to a destination system. The destination system is managed by the receiver (customer) of the webhook, or for faster and easier implementation, Tenovos Connect can automatically generate endpoints for receiving webhooks from Tenovos, or any other system. Webhooks are automated, in other words they are automatically sent out when their corresponding event occurs in Tenovos. These events occur whether you are using the Tenovos UI, or your own custom UI on top of the Tenovos platform. Version: v1.0 License: Tenovos Active Story Management ## Servers ``` https://api.tenovos.io/v2 ``` ``` https://api.uat.tenovos.io/v2 ``` ## Security ### BasicAuth Type: http Scheme: basic ### BearerAuth Type: http Scheme: bearer ### ApiKeyAuth Type: apiKey In: header Name: X-API-Key ### OAuth2 Type: oauth2 ## Download OpenAPI description [Webhooks Introduction](https://api.tenovos.com/_bundle/developer-portal/webhooks/reference.yaml) ## Assets Asset related events ### Asset Created - [POST asset.created](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.created.md): Receive a notification when an Asset in Tenovos is created. ### Asset Deleted - [POST asset.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.deleted.md): Receive a notification when an Asset in Tenovos is deleted. ### Asset Downloaded - [POST asset.downloaded](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.downloaded.md): Receive a notification when an Asset in Tenovos is downloaded. ### Asset Purged - [POST asset.purged](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.purged.md): Receive a notification when an Asset in Tenovos is purged from the Recycle Bin. ### Renditions Created - [POST asset.renditions.created](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.renditions.created.md): Receive a notification when system generated renditions for an Asset in Tenovos have completed processing. ### Asset Shared - [POST asset.shared](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.shared.md): Receive a notification when an Asset in Tenovos is shared with other users or external contacts. ### Security Updated - [POST asset.security.updated](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.security.updated.md): Receive a notification when the Security Templates applied to an Asset in Tenovos have been updated. ### Metadata Updated - [POST asset.metadata.updated](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.metadata.updated.md): Receive a notification when the Metadata applied to an Asset in Tenovos is updated. ### Asset Restored - [POST asset.restored](https://api.tenovos.com/developer-portal/webhooks/reference/assets/asset.restored.md): Receive a notification when an Asset in Tenovos is restored from the Recycle Bin and will therefore be available to users again. ## Collections Collection related events ### Collection Created - [POST collection.created](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.created.md): Receive a notification when an Collection in Tenovos is created. ### Collection Updated - [POST collection.updated](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.updated.md): Receive a notification when an asset is added to or removed from a Collection. ### Collection Deleted - [POST collection.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.deleted.md): Receive a notification when a Collection in Tenovos is deleted. ### Collection Assets Updated - [POST collection.assets.updated](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.assets.updated.md): Receive a notification when assets are added to and/or removed from a collection. ### Collection Downloaded - [POST collection.downloaded](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.downloaded.md): Receive a notification when a Collection in Tenovos is downloaded. ### Collection Shared - [POST collection.shared](https://api.tenovos.com/developer-portal/webhooks/reference/collections/collection.shared.md): Receive a notification when a Collection in Tenovos is shared. ## Metadata These events are raised when a user with Administrative privileges take various actions within the Metadata section of the Platform. This includes Metadata Templates, Metadata Groups, Controlled Vocabularies, and Metadata Attributes. ### Attribute Created - [POST metadata.attribute.created](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.attribute.created.md): Receive a notification when a Metadata Attribute is created in Tenovos. ### Attribute Deleted - [POST metadata.attribute.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.attribute.deleted.md): Receive a notification when a Metadata Attribute is deleted in Tenovos. ### Attribute Updated - [POST metadata.attribute.updated](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.attribute.updated.md): Receive a notification when a Metadata Attribute is updated in Tenovos. ### Group Created - [POST metadata.group.created](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.group.created.md): Receive a notification when a Metadata Group is created in Tenovos. ### Group Deleted - [POST metadata.group.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.group.deleted.md): Receive a notification when a Metadata Group is deleted in Tenovos. ### Group Updated - [POST metadata.group.updated](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.group.updated.md): Receive a notification when a Metadata Group is updated in Tenovos. ### Template Created - [POST metadata.template.created](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.template.created.md): Receive a notification when a Metadata Template is created in Tenovos. ### Template Deleted - [POST metadata.template.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.template.deleted.md): Receive a notification when a Metadata Template is deleted in Tenovos. ### Template Updated - [POST metadata.template.updated](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.template.updated.md): Receive a notification when a Metadata Template is updated in Tenovos. ### Vocabulary Created - [POST metadata.vocabulary.created](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.vocabulary.created.md): Receive a notification when a Metadata Vocabulary (Controlled Vocabulary) is created in Tenovos. ### Vocabulary Deleted - [POST metadata.vocabulary.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.vocabulary.deleted.md): Receive a notification when a Metadata Vocabulary list (Controlled Vocabulary) is deleted in Tenovos. This event applies to the entire list. For the deletion of individual values, use the metadata.vocabulary.updated event. ### Vocabulary Updated - [POST metadata.vocabulary.updated](https://api.tenovos.com/developer-portal/webhooks/reference/metadata/metadata.vocabulary.updated.md): Receive a notification when a Metadata Vocabulary list (Controlled Vocabulary) is updated in Tenovos. This event applies to values being added to, removed from, or renamed in an existing vocabulary. ## Requests Requests represent a **one step workflow** within Tenovos. Users with the Request Management and Request Inbox privileges can see and manage any type of request in the system. Each request is assigned a specific *type*, which can be defined based on your needs. Examples include: - Upload - Download - Asset Change - Merchandising Review - Archive In these examples, one or more assets are part of a request, and each asset can be assigned to a different user for review. The reviewer can updated the status of each asset they are assigned to, such as *Approved*, *Rejected*, *In Progress*, *Auto Approved*, etc. The request itself can also have a status. These terms are completely customizable, and therefore are not an enum in the API documentation. ### Request Created - [POST request.created](https://api.tenovos.com/developer-portal/webhooks/reference/requests/request.created.md): Receive a notification when a new Request is submitted ### Request Updated - [POST request.updated](https://api.tenovos.com/developer-portal/webhooks/reference/requests/request.updated.md): Receive a notification when a Request is updated ## Relationships Relationship related events ### Relationship Created - [POST relationship.created](https://api.tenovos.com/developer-portal/webhooks/reference/relationships/relationship.created.md): Receive a notification when an asset relationship in Tenovos is created. ### Relationship Deleted - [POST relationship.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/relationships/relationship.deleted.md): Receive a notification when an asset relationship in Tenovos is deleted. ### Relationship Updated - [POST relationship.updated](https://api.tenovos.com/developer-portal/webhooks/reference/relationships/relationship.updated.md): Receive a notification when an asset relationship in Tenovos is updated. ## Rights Management Rights Management related events. ### Project Created - [POST rm.project.created](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.project.created.md): Receive a notification when a Rights Management project in Tenovos is created. ### Project Updated - [POST rm.project.updated](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.project.updated.md): Receive a notification when a Rights Management Project in Tenovos is updated. ### Project Deleted - [POST rm.project.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.project.deleted.md): Receive a notification when a Rights Management Project in Tenovos is deleted. ### Entity Created - [POST rm.entity.created](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.entity.created.md): Receive a notification when a Rights Management entity in Tenovos is created. ### Entity Updated - [POST rm.entity.updated](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.entity.updated.md): Receive a notification when a Rights Management entity in Tenovos is updated. ### Entity Deleted - [POST rm.entity.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.entity.deleted.md): Receive a notification when a Rights Management entity in Tenovos is deleted. ### Agreement Created - [POST rm.agreement.created](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.agreement.created.md): Receive a notification when a Rights Management agreement in Tenovos is created. ### Agreement Updated - [POST rm.agreement.updated](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.agreement.updated.md): Receive a notification when a Rights Management agreement in Tenovos is updated. ### Agreement Deleted - [POST rm.agreement.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/rights-management/rm.agreement.deleted.md): Receive a notification when a Rights Management agreement in Tenovos is deleted. ## Security These events are raised when a user with Administrative privileges take various actions within the Administration section of the Platform. This includes Groups, Roles, Security Templates, and more. ### Group Created - [POST security.group.created](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.group.created.md): Receive a notification when a new user Group is created in Tenovos. ### Group Updated - [POST security.group.updated](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.group.updated.md): Receive a notification when a Security Group is updated in Tenovos. ### Group Deleted - [POST security.group.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.group.deleted.md): Receive a notification when a Security Group is deleted in Tenovos. ### Role Created - [POST security.role.created](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.role.created.md): Receive a notification when a new Group is created in Tenovos. ### Role Updated - [POST security.role.updated](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.role.updated.md): Receive a notification when a Role is updated in Tenovos. ### Role Deleted - [POST security.role.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.role.deleted.md): Receive a notification when a Role is deleted in Tenovos. ### Template Created - [POST security.template.created](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.template.created.md): Receive a notification when a Security Template is created in Tenovos. ### Template Updated - [POST security.template.updated](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.template.updated.md): Receive a notification when a Security Template is updated in Tenovos. ### Template Deleted - [POST security.template.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/security/security.template.deleted.md): Receive a notification when a Security Template is deleted in Tenovos. ## Story Boards Story Board related events ### Story Board Created - [POST storyboard.created](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.created.md): Receive a notification when a Story Board in Tenovos is created. ### Story Board Updated - [POST storyboard.updated](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.updated.md): Receive a notification when a Story Board in Tenovos is updated. ### Story Board Deleted - [POST storyboard.deleted](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.deleted.md): Receive a notification when a Story Board in Tenovos is deleted. ### Story Board Shared - [POST storyboard.shared](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.shared.md): Receive a notification when a Story Board in Tenovos is shared. ### Story Board Restored - [POST storyboard.restored](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.restored.md): Receive a notification when a Story Board in Tenovos is restored from the Recycle Bin. ### Story Board Purged - [POST storyboard.purged](https://api.tenovos.com/developer-portal/webhooks/reference/story-boards/storyboard.purged.md): Receive a notification when a Story Board in Tenovos is purged from the Recycle Bin. Once a Story Board is purged, it can't be recovered. ## Users User related events ### User Created - [POST user.created](https://api.tenovos.com/developer-portal/webhooks/reference/users/user.created.md): Receive a notification when a user account in Tenovos is created. ### User Updated - [POST user.updated](https://api.tenovos.com/developer-portal/webhooks/reference/users/user.updated.md): Receive a notification when a user account in Tenovos is updated. ## Versions ### Version Created - [POST version.created](https://api.tenovos.com/developer-portal/webhooks/reference/versions/version.created.md): Receive a notification when an Asset in Tenovos is versioned.