Subscribe to media events
Learn about FastPix media lifecycle events such as upload, creation, update, deletion, and live streaming to simplify monitoring and automation.
FastPix emits a variety of media-related events that provide insights into the lifecycle of your media assets. These events cover key stages such as when a media upload is initiated, when a media asset is created, when it becomes ready for playback, and when it fails or is deleted. By subscribing to these events, you can monitor the status of your media assets in real time and automate workflows based on changes in media status. Whether you’re tracking direct uploads, push media, or live stream creation, these events help you stay informed and responsive to the state of your media library. Below is a detailed overview of the main media events emitted by FastPix and their significance in the media lifecycle.
video.media.upload
This event is triggered when a new media asset has been successfully created in the system. It indicates that the media metadata has been registered and the media object is now part of your library. You can use this to confirm that an upload, ingest, or other input operation has led to a new media entry on the platform.
| Name | Type | Description |
|---|---|---|
| type | string | Type for the webhook event (e.g., "video.media.upload"). |
| object | object | Object information. |
| object.type | string | Type of the object (e.g., "media"). |
| object.id | string | Unique identifier for the object (e.g., "72c706ba-7c8f-458b-bfa5-3d283418ebdc"). |
| id | string | Unique identifier for the event (e.g., "134b9d7b-5ed4-4193-8cfb-9ffae9cc296c"). |
| workspace | object | Workspace information. |
| workspace.name | string | Name for the workspace. |
| workspace.id | string | Unique identifier for the workspace. |
| data | object | Media data details. |
| -data.uploadId | string | Unique identifier for the media. Max 255 characters. |
| -data.trial | boolean | Whether the URL is for a trial (e.g., false). |
| -data.status | string | URL name or _ for allowing all (e.g., "waiting"). |
| -data.url | string | URL for the media. |
| -data.timeout | integer | Time in seconds the signed upload URL is valid (e.g., 14400). |
| -data.corsOrigin | string | Allowed CORS origin (e.g., "*"). |
| -data.pushMediaSettings | object | Push media settings. |
| —data.pushMediaSettings.playbackIds | array | Playback settings for media. |
| ---data.pushMediaSettings.playbackIds[].accessPolicy | string | Access policy for playback IDs (e.g., "public"). |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions | object | Access restrictions for playback IDs. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.domains | object | Domain-based access control. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default access policy for domains (e.g., "allow"). |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.domains.allow | array | Domains allowed for playback. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.domains.deny | array | Domains denied for playback. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.userAgents | object | User-agent-based access control. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default access policy for user agents (e.g., "allow"). |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.userAgents.allow | array | User agents allowed for playback. |
| ----data.pushMediaSettings.playbackIds[].accessRestrictions.userAgents.deny | array | User agents denied for playback. |
| -data.pushMediaSettings.metadata | object | Metadata for the media (e.g., "key1": "value1"). |
| -data.pushMediaSettings.sourceAccess | boolean | Whether source access is allowed (e.g., false). |
| -data.pushMediaSettings.optimizeAudio | boolean | Whether audio optimization is enabled (e.g., false). |
| -data.pushMediaSettings.mediaQuality | string | Media quality tier for the upload (e.g., "pro"). |
| -data.pushMediaSettings.title | string | Title of the uploaded media (e.g., "videoplayback"). |
| createdAt | string (ISO 8601) | Timestamp when the event was created (e.g., "2025-04-07T09:30:10.239778258Z"). |
| attempts | array | List of attempts made to deliver the webhook. |
| -attempts[].webhookId | string | Unique identifier for the webhook attempt. |
| -attempts[].responseStatusCode | integer | HTTP response status code (e.g., 404). |
| -attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| —attempts[].responseHeaders.contentType | string | Content type of the response (e.g., "application/json"). |
| —attempts[].responseHeaders.transfer | string | Transfer encoding (if any). |
| —attempts[].responseHeaders.server | string | Server used for the response (e.g., "nginx"). |
| —attempts[].responseHeaders.date | string | Date of the response (e.g., "Mon, 07 Apr 2025 09:30:10 GMT"). |
| -attempts[].cacheControl | string | Cache control settings. |
| -attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}). |
| -attempts[].maxAttempts | integer | Maximum number of retry attempts (e.g., 30). |
| -attempts[].id | string | Unique identifier for the attempt. |
| -attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created. |
| -attempts[].address | string | URL address of the webhook. |
video.media.created
This event is fired when a direct upload has been initiated. It marks the start of the upload flow — typically when a user or system requests an upload URL and begins the process of sending a file. You can use this to track when users start uploading media to your app or service.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., "video.media.created") |
| object | object | |
| - object.type | string | Type of the object (e.g., "media") |
| - object.id | string | Unique identifier for the object (e.g., "3047ad1d-e241-4978-8c98-f08e57347847") |
| id | string | Unique identifier for the event (e.g., "4d22d706-ea36-496b-ab8a-023a59f0ac3f") |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., "Development") |
| - workspace.id | string | Unique identifier for the workspace (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe") |
| status | string | Status of the media (e.g., "media_created") |
| data | object | |
| - data.id | string | Unique identifier for the media (e.g., "bb2f5c26-afe4-4ff1-b6d2-906b761adb15") |
| - data.trial | boolean | Indicates whether the media is a trial (e.g., false) |
| - data.status | string | Status of the media (e.g., "Created") |
| - data.createdAt | string (ISO 8601) | Timestamp when the media was created (e.g., "2025-04-04T09:50:29.920507Z") |
| - data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2025-04-04T09:50:29.920526Z") |
| - data.playbackIds | array | List of playback IDs. |
| — data.playbackIds[].id | string | Unique identifier for the playback ID (e.g., "39cff93a-c141-4f5e-816e-3c969f277a60") |
| — data.playbackIds[].accessPolicy | string | Access policy for playback IDs (e.g., "public") |
| — data.playbackIds[].accessRestrictions | object | Access restrictions for domains and user agents. |
| --- data.playbackIds[].accessRestrictions.domains | object | Domain-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default policy for domains (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.domains.allow | array | List of allowed domains. |
| ---- data.playbackIds[].accessRestrictions.domains.deny | array | List of denied domains. |
| --- data.playbackIds[].accessRestrictions.userAgents | object | User agent-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| ---- data.playbackIds[].accessRestrictions.userAgents.deny | array | List of denied user agents. |
| - data.metadata | object | Metadata associated with the media. |
| — data.metadata.key1 | string | Key-value pair for metadata (e.g., "key1": "value1") |
| - data.sourceAccess | boolean | Indicates if source access is enabled (e.g., true) |
| - data.maxResolution | string | Maximum resolution for encoding, storing, and streaming media (e.g., "1080p") |
| - data.inputs | array | List of media inputs. |
| — data.inputs[].type | string | Type of the media input (e.g., "video") |
| — data.inputs[].url | string | URL of the media input (e.g., "https://static.fastpix.com/sample.mp4") |
| - data.optimizeAudio | boolean | Indicates if audio optimization is enabled (e.g., false) |
| - data.mediaQuality | string | Media quality tier for the media (e.g., "pro") |
| - data.title | string | Title of the media (e.g., "fp-sample-video") |
| createdAt | string (ISO 8601) | Timestamp when the event was created (e.g., "2025-04-04T09:50:30.946240483Z") |
| attempts | array | List of attempts made to deliver the webhook. |
| - attempts[].webhookId | string | Unique identifier for the webhook attempt (e.g., "3b0ab5b1-6523-4c13-8012-1d096c150b8e") |
| - attempts[].responseStatusCode | integer | HTTP status code of the response (e.g., 404) |
| - attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| — attempts[].responseHeaders.contentType | string | Content type of the response (e.g., "application/json") |
| — attempts[].responseHeaders.transfer | ||
| — attempts[].responseHeaders.server | string | Server used for the response (e.g., "nginx") |
| — attempts[].responseHeaders.date | string | Date of the response (e.g., "Fri, 04 Apr 2025 09:50:31 GMT") |
| — attempts[].responseHeaders.cacheControl | ||
| - attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}) |
| - attempts[].maxAttempts | integer | Maximum number of retry attempts (e.g., 30) |
| - attempts[].id | string | Unique identifier for the attempt (e.g., "cfa372da-e468-4ec4-bc50-ba6e0a84c03c") |
| - attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created (e.g., "2025-04-04T09:50:30.946240483Z") |
| - attempts[].address | string | URL address of the webhook (e.g., "https://webhook.site/24618f1c-c82c-4588-b9c6-1d86aac2a9b3") |
video.upload.media_created
Once a user completes uploading a file through a direct upload URL, the system creates a corresponding media object, triggering this event. It signals that the uploaded file has been accepted and a media asset has been registered, though it may still be processing.
| Name | Type | Description |
|---|---|---|
| type | string | Type for the webhook event (e.g., "video.upload.media_created") |
| object | object | |
| - object.type | string | Type of the object (e.g., "media") |
| - object.id | string | Unique identifier for the object (e.g., "72c706ba-7c8f-458b-bfa5-3d283418ebdc") |
| id | string | Unique identifier for the event (e.g., "09da05f0-051a-4e0a-97f5-14677fa4f072") |
| workspace | object | |
| - workspace.name | string | Name of the workspace (e.g., "Development") |
| - workspace.id | string | Unique identifier for the workspace (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe") |
| status | string | Status of the media (e.g., "media_created") |
| data | object | |
| - data.id | string | Unique identifier for the media (e.g., "d49e44c7-df42-4ffa-9764-8dea1543b63e") |
| - data.workspaceId | string | Unique identifier for the workspace (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe") |
| - data.mediaQuality | string | Media quality tier for the media (e.g., "pro") |
| - data.maxResolution | string | Maximum resolution for encoding, storing, and streaming media (e.g., "1080p") |
| - data.playbackIds | array | List of playback IDs. |
| — data.playbackIds[].id | string | Unique identifier for the playback ID (e.g., "c123022c-32fb-4c53-acc6-2c09098ba0b5") |
| — data.playbackIds[].accessPolicy | string | Access policy for playback IDs (e.g., "public") |
| — data.playbackIds[].accessRestrictions | object | Access restrictions for domains and user agents. |
| --- data.playbackIds[].accessRestrictions.domains | object | Domain-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default policy for domains (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.domains.allow | array | List of allowed domains. |
| ---- data.playbackIds[].accessRestrictions.domains.deny | array | List of denied domains. |
| --- data.playbackIds[].accessRestrictions.userAgents | object | User agent-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| ---- data.playbackIds[].accessRestrictions.userAgents.deny | array | List of denied user agents. |
| - data.sourceAccess | boolean | Indicates if source access is enabled (e.g., false) |
| - data.mp4Support | string | MP4 support status (e.g., "none") |
| - data.optimizeAudio | boolean | Indicates if audio optimization is enabled (e.g., false) |
| - data.duration | string | Duration of the media (e.g., "00:00:00") |
| - data.createdAt | string (ISO 8601) | Timestamp when the media was created (e.g., "2025-04-07T09:30:31.728664Z") |
| - data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2025-04-07T09:30:31.728666Z") |
| createdAt | string (ISO 8601) | Timestamp when the event was created (e.g., "2025-04-07T09:30:31.850369075Z") |
| attempts | array | List of attempts made to deliver the webhook. |
| - attempts[].webhookId | string | Unique identifier for the webhook attempt (e.g., "3b0ab5b1-6523-4c13-8012-1d096c150b8e") |
| - attempts[].responseStatusCode | integer | HTTP status code of the response (e.g., 404) |
| - attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| — attempts[].responseHeaders.contentType | string | Content type of the response (e.g., "application/json") |
| — attempts[].responseHeaders.transfer | ||
| — attempts[].responseHeaders.server | string | Server used for the response (e.g., "nginx") |
| — attempts[].responseHeaders.date | string | Date of the response (e.g., "Mon, 07 Apr 2025 09:30:32 GMT") |
| — attempts[].responseHeaders.cacheControl | ||
| - attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}) |
| - attempts[].maxAttempts | integer | Maximum number of retry attempts (e.g., 30) |
| - attempts[].id | string | Unique identifier for the attempt (e.g., "0390b11e-ebf5-410a-b8e4-80cbd23ab749") |
| - attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created (e.g., "2025-04-07T09:30:31.850369075Z") |
| - attempts[].address | string | URL address of the webhook (e.g., "https://webhook.site/24618f1c-c82c-4588-b9c6-1d86aac2a9b3") |
video.media.ready
Once the media (either video or audio) has been fully processed and is ready for playback, this event is fired. At this stage, the playbackId becomes available, which means the media can be streamed or embedded within your application. This is one of the most critical signals for transitioning from ingest to playback.
| Name | Type | Description |
|---|---|---|
| type | string | Type for the webhook event (e.g., "video.media.ready") |
| object | object | |
| - object.type | string | Type of the object (e.g., "media") |
| - object.id | string | Unique identifier for the object (e.g., "72c706ba-7c8f-458b-bfa5-3d283418ebdc") |
| id | string | Unique identifier for the event (e.g., "66320fbc-21df-406c-9b71-5c7260710d67") |
| workspace | object | |
| - workspace.name | string | Unique identifier for the environment (e.g., "Development") |
| - workspace.id | string | Name for the environment (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe") |
| status | string | Status of the media (e.g., "ready") |
| data | object | |
| - data.thumbnail | string | URL to the media thumbnail (e.g., "https://images.fastpix.com/c123022c-32fb-4c53-acc6-2c09098ba0b5/thumbnail.png") |
| - data.id | string | Unique identifier for the media (e.g., "d49e44c7-df42-4ffa-9764-8dea1543b63e") |
| - data.workspaceId | string | Workspace ID for the media (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe") |
| - data.maxResolution | string | Maximum resolution for encoding (e.g., "1080p") |
| - data.sourceResolution | string | Source resolution for the media (e.g., "1080p") |
| - data.playbackIds | array | Playback settings for the media. |
| — data.playbackIds[].id | string | Unique identifier for the playback ID (e.g., "c123022c-32fb-4c53-acc6-2c09098ba0b5") |
| — data.playbackIds[].accessPolicy | string | Access policy for playback IDs (e.g., "public") |
| — data.playbackIds[].accessRestrictions | object | Access restrictions for playback IDs. |
| --- data.playbackIds[].accessRestrictions.domains | object | Domain-based access control. |
| ---- data.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default access policy for domains (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.domains.allow | array | Domains allowed for playback (empty array means unrestricted) |
| ---- data.playbackIds[].accessRestrictions.domains.deny | array | Domains denied for playback |
| --- data.playbackIds[].accessRestrictions.userAgents | object | User-agent-based access control |
| ---- data.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default access policy for user agents (e.g., "allow") |
| ---- data.playbackIds[].accessRestrictions.userAgents.allow | array | User agents allowed for playback |
| ---- data.playbackIds[].accessRestrictions.userAgents.deny | array | User agents denied for playback |
| - data.tracks | array | Media tracks for the media |
| — data.tracks[].id | string | Unique identifier for the track (e.g., "ed8b563c-7c3e-4bad-a74c-3e4ce0afa919") |
| — data.tracks[].type | string | Type of track (e.g., "audio", "video") |
| — data.tracks[].status | string | Status of the track (e.g., "available") |
| — data.tracks[].languageCode | string | Language code for the track (e.g., "und") |
| — data.tracks[].languageName | string | Language name for the track (e.g., "default") |
| — data.tracks[].width | Width of the video (optional) | |
| — data.tracks[].height | Height of the video (optional) | |
| — data.tracks[].frameRate | Frame rate of the video (optional) | |
| - data.sourceAccess | boolean | Whether source access is allowed (e.g., false) |
| - data.mp4Support | string | MP4 support for the media (e.g., "none") |
| - data.optimizeAudio | boolean | Whether audio optimization is enabled (e.g., false) |
| - data.duration | string | Duration of the media (e.g., "00:00:22") |
| - data.aspectRatio | string | Aspect ratio for the media (e.g., "16:9") |
| - data.createdAt | string (ISO 8601) | Timestamp when the media was created (e.g., "2025-04-07T08:42:46.158789Z") |
| - data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2025-04-07T08:42:55.921248Z") |
| - data.mediaQuality | string | Media quality tier for the media (e.g., "pro") |
| createdAt | string (ISO 8601) | Timestamp when the event was created (e.g., "2025-04-07T09:30:40.636687200Z") |
| attempts | array | List of attempts made to deliver the webhook. |
| - attempts[].webhookId | string | Unique identifier for the webhook attempt (e.g., "3b0ab5b1-6523-4c13-8012-1d096c150b8e") |
| - attempts[].responseStatusCode | integer | HTTP status code of the response (e.g., 404) |
| - attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| — attempts[].responseHeaders.contentType | string | Content type of the response (e.g., "application/json") |
| — attempts[].responseHeaders.transfer | Transfer encoding (if any) | |
| — attempts[].responseHeaders.server | string | Server used for the response (e.g., "nginx") |
| — attempts[].responseHeaders.date | string | Date of the response (e.g., "Mon, 07 Apr 2025 09:30:40 GMT") |
| — attempts[].responseHeaders.cacheControl | Cache control settings (if any) | |
| - attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}) |
| - attempts[].maxAttempts | integer | Maximum number of retry attempts (e.g., 30) |
| - attempts[].id | string | Unique identifier for the attempt (e.g., "d3380d25-564d-48c7-9baf-82aabef9c191") |
| - attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created (e.g., "2025-04-07T09:30:40.636687200Z") |
| - attempts[].address | string | URL address of the webhook (e.g., "https://webhook.site/24618f1c-c82c-4588-b9c6-1d86aac2a9b3") |
video.media.non_standard_format.detected
This event is triggered when the platform detects that an uploaded media asset uses a non-standard format (for example, an unusually high bitrate) that may affect processing or playback. Use this to flag or re-encode media that falls outside recommended encoding parameters.
| Name | Type | Description |
|---|---|---|
| type | string | Type for the webhook event (e.g., "video.media.non_standard_format.detected") |
| object | object | |
| - object.type | string | Type of the object (e.g., "media") |
| - object.id | string | Unique identifier for the object (e.g., "3047ad1d-e241-4978-8c98-f08e57347847") |
| id | string | Unique identifier for the event (e.g., "986d0f91-e1a9-4ac1-a4b9-2c14cf6be138") |
| workspace | object | |
| - workspace.name | string | Name of the workspace (e.g., "Development") |
| - workspace.id | string | Unique identifier for the workspace (e.g., "338acdeb-29d4-438b-a40c-1d4105134462") |
| status | string | Status of the media (e.g., "media_created") |
| data | object | |
| - data.id | string | Unique identifier for the media (e.g., "3047ad1d-e241-4978-8c98-f08e57347847") |
| - data.workspaceId | string | Unique identifier for the workspace (e.g., "338acdeb-29d4-438b-a40c-1d4105134462") |
| - data.mediaQuality | string | Media quality tier for the media (e.g., "pro") |
| - data.maxResolution | string | Maximum resolution for encoding, storing, and streaming media (e.g., "1080p") |
| - data.sourceAccess | boolean | Indicates if source access is enabled (e.g., false) |
| - data.mp4Support | string | MP4 support status (e.g., "none") |
| - data.optimizeAudio | boolean | Indicates if audio optimization is enabled (e.g., false) |
| - data.duration | string | Duration of the media (e.g., "00:00:00") |
| - data.createdAt | string (ISO 8601) | Timestamp when the media was created (e.g., "2026-07-01T08:55:44.982516Z") |
| - data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2026-07-01T08:55:49.588318Z") |
| - data.nonStandardFormatReason | object | Details of the non-standard format that was detected. |
| — data.nonStandardFormatReason.bitrate | string | Reason describing the non-standard bitrate (e.g., "very_high - 40.09Mbps") |
| createdAt | string (ISO 8601) | Timestamp when the event was created (e.g., "2026-07-01T08:55:49.860910401Z") |
| attempts | array | List of attempts made to deliver the webhook. |
video.media.failed
If a media asset encounters an error during processing, this event is triggered. Common causes include invalid input files, corrupted data, or inaccessible URLs. This is a key signal to notify your system or end users that something went wrong, enabling better error reporting and handling workflows.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., "video.media.failed"). |
| object | object | Object information. |
| object.type | string | Type of the object (e.g., "media"). |
| object.id | string | Unique identifier for the object (e.g., "0535af74-0f63-4703-a2d8-f37a595a1794"). |
| id | string | Unique identifier for the event. |
| workspace | object | Workspace information. |
| workspace.name | string | Name of the workspace (e.g., "Development"). |
| workspace.id | string | Unique identifier for the workspace. |
| status | string | Status of the media (e.g., "failed"). |
| data | object | Media data object. |
| -data.id | string | Unique identifier for the media. |
| -data.workspaceId | string | Unique identifier for the workspace. |
| -data.mediaQuality | string | Media quality tier for the media (e.g., "pro"). |
| -data.maxResolution | string | Maximum resolution for encoding, storing, and streaming media. |
| -data.playbackIds | array | List of playback IDs. |
| —data.playbackIds[].id | string | Unique identifier for the playback ID. |
| —data.playbackIds[].accessPolicy | string | Access policy for playback IDs. |
| —data.playbackIds[].accessRestrictions | object | Access restrictions for domains and user agents. |
| ---data.playbackIds[].accessRestrictions.domains | object | Domain-based access restrictions. |
| ----data.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default policy for domains. |
| ----data.playbackIds[].accessRestrictions.domains.allow | array | List of allowed domains. |
| ----data.playbackIds[].accessRestrictions.domains.deny | array | List of denied domains. |
| ----data.playbackIds[].accessRestrictions.userAgents | object | User agent-based access restrictions. |
| ----data.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents. |
| ----data.playbackIds[].accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| ----data.playbackIds[].accessRestrictions.userAgents.deny | array | List of denied user agents. |
| -data.sourceAccess | boolean | Indicates if source access is enabled. |
| -data.mp4Support | string | Indicates MP4 support (e.g., "none"). |
| -data.optimizeAudio | boolean | Indicates if audio optimization is enabled. |
| -data.duration | string | Duration of the media (e.g., "00:00:00"). |
| -data.createdAt | string (ISO 8601) | Timestamp when the media was created. |
| -data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated. |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |
| -attempts[].webhookId | string | Unique identifier for the webhook attempt. |
| -attempts[].responseStatusCode | integer | HTTP status code of the response. |
| -attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| —attempts[].responseHeaders.contentType | string | Content type of the response. |
| —attempts[].responseHeaders.transfer | string | Transfer encoding (if any). |
| —attempts[].responseHeaders.server | string | Server used for the response. |
| —attempts[].responseHeaders.date | string | Date of the response. |
| —attempts[].responseHeaders.cacheControl | string | Cache control headers (if any). |
| -attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}). |
| -attempts[].maxAttempts | integer | Maximum number of retry attempts. |
| -attempts[].id | string | Unique identifier for the attempt. |
| -attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created. |
| -attempts[].address | string | URL address of the webhook. |
video.media.updated
This event occurs when any updates are made to an existing media asset. Changes might include modifications to metadata, privacy settings, thumbnail updates, or other attributes related to the media. Use this webhook to keep your system in sync with any adjustments made on the platform.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., “video.media.updated”). |
| object | object | |
| - object.type | string | Type of the object (e.g., "media"). |
| - object.id | string | Unique identifier for the object (e.g., "3047ad1d-e241-4978-8c98-f08e57347847"). |
| id | string | Unique identifier for the event (e.g., “35f0f881-2b84-47b5-b592-559269fb62eb”). |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., “Development”). |
| - workspace.id | string | Unique identifier for the workspace (e.g., “6dc2b4e0-0615-42fd-a580-1f4aad932dfe”). |
| status | string | Status of the media (e.g., “media_created”). |
| data | object | Additional data related to the event. |
| - data.mediaQuality | string | Media quality tier for the media (e.g., "pro"). |
| - data.thumbnail | string | URL to the media thumbnail. |
| - data.metadata | object | User-supplied metadata associated with the media. |
| - data.sourceResolution | string | Source resolution of the media (e.g., "1080"). |
| - data.creatorId | string | Identifier of the media creator (e.g., "5463425"). |
| - data.sourceAccess | boolean | Indicates if source access is enabled (e.g., false). |
| - data.isAudioOnly | boolean | Indicates if the media contains only audio (e.g., false). |
| - data.aspectRatio | string | Aspect ratio for the media (e.g., "16:9"). |
| - data.title | string | Title of the media (e.g., "update-media"). |
| - data.subtitleAvailable | boolean | Indicates if subtitles are available (e.g., false). |
| - data.playbackIds | array | List of playback IDs. |
| — data.playbackIds[].id | string | Unique identifier for the playback ID. |
| — data.playbackIds[].accessPolicy | string | Access policy for playback IDs (e.g., "public"). |
| — data.playbackIds[].accessRestrictions | object | Access restrictions for domains and user agents. |
| --- data.playbackIds[].accessRestrictions.domains | object | Domain-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.domains.defaultPolicy | string | Default policy for domains (e.g., "allow"). |
| ---- data.playbackIds[].accessRestrictions.domains.allow | array | List of allowed domains. |
| ---- data.playbackIds[].accessRestrictions.domains.deny | array | List of denied domains. |
| --- data.playbackIds[].accessRestrictions.userAgents | object | User agent-based access restrictions. |
| ---- data.playbackIds[].accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents (e.g., "allow"). |
| ---- data.playbackIds[].accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| ---- data.playbackIds[].accessRestrictions.userAgents.deny | array | List of denied user agents. |
| - data.tracks | array | Media tracks for the media. |
| — data.tracks[].id | string | Unique identifier for the track. |
| — data.tracks[].type | string | Type of track (e.g., "audio", "video"). |
| — data.tracks[].status | string | Status of the track (e.g., "available"). |
| — data.tracks[].width | integer | Width of the video track (optional). |
| — data.tracks[].height | integer | Height of the video track (optional). |
| — data.tracks[].frameRate | string | Frame rate of the video track (optional). |
| — data.tracks[].languageCode | string | Language code for the track (e.g., "und"). |
| — data.tracks[].languageName | string | Language name for the track (e.g., "default"). |
| - data.maxResolution | string | Maximum resolution for the media (e.g., "1080p"). |
| - data.duration | string | Duration of the media (e.g., "00:00:10"). |
| - data.thirdPartyId | string | Third-party identifier for the media. |
| - data.createdAt | string (ISO 8601) | Timestamp when the media was created (e.g., "2026-07-01T08:55:44.982516Z"). |
| - data.generatedSubtitles | array | List of generated subtitles for the media. |
| - data.id | string | Unique identifier for the media (e.g., "3047ad1d-e241-4978-8c98-f08e57347847"). |
| - data.workspaceId | string | Unique identifier for the workspace (e.g., "338acdeb-29d4-438b-a40c-1d4105134462"). |
| - data.status | string | Status of the media (e.g., "Ready"). |
| - data.updatedAt | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2026-07-01T09:01:09.224330Z"). |
| createdAt | string | Date and time when the event was created (e.g., “2025-04-09T05:27:47.373470087Z”). |
| attempts | array | List of attempts made to handle the webhook. |
| - attempts.webhookId | string | Unique identifier for the webhook attempt (e.g., “3b0ab5b1-6523-4c13-8012-1d096c150b8e”). |
| - attempts.responseStatusCode | int | Response status code from the webhook (e.g., 404). |
| - attempts.responseHeaders | object | Response headers returned from the webhook. |
| - attempts.responseHeaders.contentType | string | Content type in the response header (e.g., “application/json”). |
| - attempts.responseHeaders.transfer | string | Transfer encoding in the response header (e.g., “chunked”). |
| - attempts.responseHeaders.server | string | Server used in the response (e.g., “nginx”). |
| - attempts.responseHeaders.date | string | Date of the response (e.g., “Wed, 09 Apr 2025 05:27:47 GMT”). |
| - attempts.responseHeaders.cacheControl | string | Cache control directives (e.g., “no-cache, private”). |
| - attempts.responseBody | string | Response body returned from the webhook (e.g., {"success":false,"error":{"message":"Token \"24618f1c-c82c-4588-b9c6-1d86aac2a9b3\" not found","id":""}}) |
| - attempts.maxAttempts | int | Maximum number of allowed attempts (e.g., 30). |
| - attempts.id | string | Unique identifier for the attempt (e.g., “9a7b39a9-7c1e-4937-8427-33929c4676e9”). |
| - attempts.createdAt | string | Date and time when the attempt was created (e.g., “2025-04-09T05:27:47.373470087Z”). |
| - attempts.address | string | Webhook address |
video.media.deleted
This event is triggered when a media asset has been permanently deleted from the system. It serves as a signal to remove any references to the media from your database or UI, as the content is no longer accessible or playable.
| Name | Type | Description |
|---|---|---|
| type | string | Type for the webhook event (e.g., "video.media.deleted"). |
| object | object | Object information. |
| object.type | string | Type of the object (e.g., "media"). |
| object.id | string | Unique identifier for the object (e.g., "3047ad1d-e241-4978-8c98-f08e57347847"). |
| id | string | Unique identifier for the event. |
| workspace | object | Workspace information. |
| workspace.name | string | Unique identifier for the environment (e.g., null). |
| workspace.id | string | Name for the environment (e.g., "6dc2b4e0-0615-42fd-a580-1f4aad932dfe"). |
| status | string | Status of the media (e.g., "media_created"). |
| data | object | Event-specific data. |
| data.success | boolean | Indicates if the media deletion was successful (e.g., true). |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |
| attempts[].webhookId | string | Unique identifier for the webhook attempt. |
| attempts[].responseStatusCode | integer | HTTP status code of the response. |
| attempts[].responseHeaders | object | Response headers for the webhook attempt. |
| attempts[].responseHeaders.contentType | string | Content type of the response (e.g., "application/json"). |
| attempts[].responseHeaders.transfer | string | Transfer encoding (if applicable). |
| attempts[].responseHeaders.server | string | Server used for the response (e.g., "nginx"). |
| attempts[].responseHeaders.date | string | Date of the response. |
| attempts[].responseHeaders.cacheControl | string | Cache control headers (if any). |
| attempts[].responseBody | string | Body of the response (e.g., {"success":false,...}). |
| attempts[].maxAttempts | integer | Maximum number of retry attempts (e.g., 30). |
| attempts[].id | string | Unique identifier for the attempt. |
| attempts[].createdAt | string (ISO 8601) | Timestamp when the attempt was created. |
| attempts[].address | string | URL address of the webhook. |
video.media.live_stream.created
Triggered when a live stream has ended and the recorded session is successfully saved as an on-demand media asset. This event indicates that a manifest file has been generated and a playbackId is now available for streaming. It’s typically used to initiate downstream workflows like publishing the recorded content, updating the media library, or notifying users that the replay is ready. This event is critical for platforms that offer live-to-VOD workflows, such as sports replays, webinars, or events with post-stream availability.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., video.media.live_stream.created). |
| id | string | Unique identifier for the event (e.g., a1d42951-0343-4092-a50f-a172fe6a734d). |
| object | object | Information about the media object. |
| ─ object.type | string | Type of object (e.g., media). |
| ─ object.id | string | Unique identifier for the media object (e.g., 03233fc7-4fef-4b4e-b9b8-a320dbdfe00c). |
| workspace | object | Workspace information. |
| ─ workspace.name | string | Name of the workspace (e.g., FastPix website and docs videos). |
| ─ workspace.id | string | Unique identifier for the workspace (e.g., 89391808-c367-41b2-8561-c6e05ea22dfc). |
| status | string | Status of the media (e.g., media_created). |
| data | object | Additional data related to the event. |
| ─ data.id | string | Unique identifier for the media (same as object.id). |
| ─ data.workspaceId | string | ID of the workspace the media belongs to. |
| ─ data.mediaQuality | string | Media quality tier for the media (e.g., pro). |
| ─ data.maxResolution | string | Maximum resolution available (e.g., 1080p). |
| ─ data.playbackIds | array | Array of playback ID objects. |
| ─── id | string | Playback ID (e.g., f59844b5-0775-43f6-b170-8c871d6dee57). |
| ─── accessPolicy | string | Playback access policy (e.g., public). |
| ─── accessRestrictions | object | Domain and user agent-based access rules. |
| ──── domains | object | Domain restriction settings. |
| ───── defaultPolicy | string | Default domain policy (e.g., allow). |
| ───── allow | array | List of allowed domains. |
| ───── deny | array | List of denied domains. |
| ──── userAgents | object | User-agent restriction settings. |
| ───── defaultPolicy | string | Default user-agent policy (e.g., allow). |
| ───── allow | array | List of allowed user agents. |
| ───── deny | array | List of denied user agents. |
| ─ data.sourceAccess | boolean | Whether source access is enabled (e.g., false). |
| ─ data.mp4Support | string | MP4 support status (e.g., none). |
| ─ data.optimizeAudio | boolean | Whether audio optimization is enabled (e.g., false). |
| ─ data.duration | string | Duration of the video (e.g., 00:02:38). |
| ─ data.createdAt | string | Timestamp when the media was created (e.g., 2025-02-25T10:44:30.466315Z). |
| ─ data.updatedAt | string | Timestamp when the media was last updated (e.g., 2025-02-25T10:44:30.466323Z). |
| createdAt | string | Timestamp when the event was created (e.g., 2025-02-25T10:44:30.488707977Z). |
| attempts | array | List of processing attempts (empty array if none). |
video.media.live_clip.created
Triggered when a clip is created from a live stream and saved as an on-demand media asset. This event indicates that a new media object has been generated for the clip and a playbackId is now available for streaming. Use it to publish live clips, update the media library, or notify users that the clip is ready.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., video.media.live_clip.created). |
| id | string | Unique identifier for the event (e.g., db3a5953-1f3a-4eca-9520-42152a369f99). |
| object | object | Information about the media object. |
| ─ object.type | string | Type of object (e.g., media). |
| ─ object.id | string | Unique identifier for the media object (e.g., ebb227a2-5d05-438d-8161-5b159bbeb5c2). |
| workspace | object | Workspace information. |
| ─ workspace.name | string | Name of the workspace (e.g., Development). |
| ─ workspace.id | string | Unique identifier for the workspace (e.g., 338acdeb-29d4-438b-a40c-1d4105134462). |
| status | string | Status of the media (e.g., media_created). |
| data | object | Additional data related to the event. |
| ─ data.id | string | Unique identifier for the media (same as object.id). |
| ─ data.workspaceId | string | ID of the workspace the media belongs to. |
| ─ data.mediaQuality | string | Media quality tier for the media (e.g., pro). |
| ─ data.maxResolution | string | Maximum resolution available (e.g., 1080p). |
| ─ data.sourceAccess | boolean | Whether source access is enabled (e.g., false). |
| ─ data.mp4Support | string | MP4 support status (e.g., none). |
| ─ data.optimizeAudio | boolean | Whether audio optimization is enabled (e.g., false). |
| ─ data.duration | string | Duration of the video (e.g., 00:00:00). |
| ─ data.createdAt | string | Timestamp when the media was created (e.g., 2026-07-01T09:27:59.992006Z). |
| ─ data.updatedAt | string | Timestamp when the media was last updated (e.g., 2026-07-01T09:27:59.992006Z). |
| ─ data.playbackIds | array | Array of playback ID objects. |
| ─── id | string | Playback ID (e.g., a1f24878-2fef-4c18-b17c-9c2557866a24). |
| ─── accessPolicy | string | Playback access policy (e.g., public). |
| ─── accessRestrictions | object | Domain and user agent-based access rules. |
| ──── domains | object | Domain restriction settings. |
| ───── defaultPolicy | string | Default domain policy (e.g., allow). |
| ───── allow | array | List of allowed domains. |
| ───── deny | array | List of denied domains. |
| ──── userAgents | object | User-agent restriction settings. |
| ───── defaultPolicy | string | Default user-agent policy (e.g., allow). |
| ───── allow | array | List of allowed user agents. |
| ───── deny | array | List of denied user agents. |
| createdAt | string | Timestamp when the event was created (e.g., 2026-07-01T09:28:00.070107683Z). |
| attempts | array | List of processing attempts (empty array if none). |
video.media.upload.cancelled
| Field | Type | Example | Description |
|---|---|---|---|
| type | string | ”video.media.upload.cancelled” | The event type. |
| object.type | string | ”media” | The type of the object related to the event. |
| object.id | string | ”9a9038fa-e79d-4a6e-8f73-200a8b7a28fa” | The unique identifier of the media object. |
| id | string | ”5e4271c2-d2cd-4d2f-8343-cead89aba166” | The unique identifier for this event. |
| workspace.name | string | ”Development” | The name of the workspace where the event occurred. |
| workspace.id | string | ”ba52f106-1f3f-4a2a-84dd-1b7f96b35604” | The unique identifier of the workspace. |
| data.uploadId | string | ”9a9038fa-e79d-4a6e-8f73-200a8b7a28fa” | The unique identifier of the upload. |
| data.trial | boolean | false | Indicates if the upload was a trial. |
| data.status | string | ”waiting” | The status of the upload at the time of cancellation. |
| data.url | string | ”https://example.com/upload?signature=…” | The signed URL for the upload. |
| data.timeout | integer | 14400 | The timeout value for the upload (in seconds). |
| data.corsOrigin | string | ”*“ | The CORS origin allowed for the upload. |
| data.pushMediaSettings.playbackIds | array (objects) | [{“accessPolicy”:“public”,“accessRestrictions”:{}}] | Playback IDs and their access policies/restrictions. |
| data.pushMediaSettings.metadata | object | {“name”:“fastpix”} | Metadata associated with the upload. |
| data.pushMediaSettings.sourceAccess | boolean | false | Whether the original media file is accessible. |
| data.pushMediaSettings.optimizeAudio | boolean | false | Whether audio optimization was enabled. |
| data.pushMediaSettings.mediaQuality | string | ”pro” | The media quality tier for the upload. |
| data.pushMediaSettings.thirdPartyId | string | ”13456783” | A third-party identifier associated with the upload. |
| createdAt | string | ”2025-04-07T09:30:40.636Z” | The creation time of the event (ISO 8601). |
| attempts | array | [] | List of attempts (if any) for this event. |
video.playbackId.created
Triggered when a new playback ID is created for a media asset. The event includes the playback ID’s access policy and any access restrictions applied to domains and user agents.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., “video.playbackId.created”). |
| object | object | Object information. |
| - object.type | string | Type of the object (e.g., “media”). |
| - object.id | string | Unique identifier for the media object (e.g., “b9856f45-e166-4e11-b05c-c0e13dafd656”). |
| id | string | Unique identifier for the event (e.g., “cb31abc0-7f39-4176-995b-02b18be725e1”). |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., “Development”). |
| - workspace.id | string | Unique identifier for the workspace (e.g., “338acdeb-29d4-438b-a40c-1d4105134462”). |
| status | string | Status of the media (e.g., “media_created”). |
| data | object | |
| - data.id | string | Unique identifier for the playback ID (e.g., “8991e06b-8fdc-49a4-8a72-bde51bd3f556”). |
| - data.accessPolicy | string | Access policy for the playback ID (e.g., “public”). |
| - data.accessRestrictions | object | Access restrictions for domains and user agents. |
| — data.accessRestrictions.userAgents | object | User agent-based access restrictions. |
| --- data.accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| --- data.accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents (e.g., “allow”). |
| --- data.accessRestrictions.userAgents.deny | array | List of denied user agents. |
| — data.accessRestrictions.domains | object | Domain-based access restrictions. |
| --- data.accessRestrictions.domains.allow | array | List of allowed domains. |
| --- data.accessRestrictions.domains.defaultPolicy | string | Default policy for domains (e.g., “allow”). |
| --- data.accessRestrictions.domains.deny | array | List of denied domains. |
| - data.resolution | string | Resolution associated with the playback ID (e.g., null). |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |
video.playbackId.deleted
Triggered when a playback ID is deleted from a media asset. The event includes the playback ID, its access policy, and any access restrictions that were applied.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., “video.playbackId.deleted”). |
| object | object | Object information. |
| - object.type | string | Type of the object (e.g., “media”). |
| - object.id | string | Unique identifier for the media object (e.g., “b9856f45-e166-4e11-b05c-c0e13dafd656”). |
| id | string | Unique identifier for the event (e.g., “cb31abc0-7f39-4176-995b-02b18be725e1”). |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., “Development”). |
| - workspace.id | string | Unique identifier for the workspace (e.g., “338acdeb-29d4-438b-a40c-1d4105134462”). |
| status | string | Status of the media (e.g., “media_created”). |
| data | object | |
| - data.id | string | Unique identifier for the playback ID (e.g., “8991e06b-8fdc-49a4-8a72-bde51bd3f556”). |
| - data.accessPolicy | string | Access policy for the playback ID (e.g., “public”). |
| - data.accessRestrictions | object | Access restrictions for domains and user agents. |
| — data.accessRestrictions.userAgents | object | User agent-based access restrictions. |
| --- data.accessRestrictions.userAgents.allow | array | List of allowed user agents. |
| --- data.accessRestrictions.userAgents.defaultPolicy | string | Default policy for user agents (e.g., “allow”). |
| --- data.accessRestrictions.userAgents.deny | array | List of denied user agents. |
| — data.accessRestrictions.domains | object | Domain-based access restrictions. |
| --- data.accessRestrictions.domains.allow | array | List of allowed domains. |
| --- data.accessRestrictions.domains.defaultPolicy | string | Default policy for domains (e.g., “allow”). |
| --- data.accessRestrictions.domains.deny | array | List of denied domains. |
| - data.resolution | string | Resolution associated with the playback ID (e.g., null). |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |
video.playbackId.domains.updated
Triggered when the domain-based access restrictions for a playback ID are updated. The event includes the updated allow list, deny list, and default policy for domains.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., “video.playbackId.domains.updated”). |
| object | object | Object information. |
| - object.type | string | Type of the object (e.g., “media”). |
| - object.id | string | Unique identifier for the media object (e.g., “b9856f45-e166-4e11-b05c-c0e13dafd656”). |
| id | string | Unique identifier for the event (e.g., “ae3e424e-7c9a-45c8-a9d0-9f8624535a68”). |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., “Development”). |
| - workspace.id | string | Unique identifier for the workspace (e.g., “338acdeb-29d4-438b-a40c-1d4105134462”). |
| status | string | Status of the media (e.g., “media_created”). |
| data | object | |
| - data.allow | array | List of allowed domains (e.g., [“livepush.io”]). |
| - data.defaultPolicy | string | Default policy for domains (e.g., “deny”). |
| - data.deny | array | List of denied domains. |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |
video.playbackId.user-agents.updated
Triggered when the user-agent-based access restrictions for a playback ID are updated. The event includes the updated allow list, deny list, and default policy for user agents.
| Name | Type | Description |
|---|---|---|
| type | string | Type of event (e.g., “video.playbackId.user-agents.updated”). |
| object | object | Object information. |
| - object.type | string | Type of the object (e.g., “media”). |
| - object.id | string | Unique identifier for the media object (e.g., “b9856f45-e166-4e11-b05c-c0e13dafd656”). |
| id | string | Unique identifier for the event (e.g., “ce09f91b-1c24-4314-897e-9551a5666eff”). |
| workspace | object | Workspace information. |
| - workspace.name | string | Name of the workspace (e.g., “Development”). |
| - workspace.id | string | Unique identifier for the workspace (e.g., “338acdeb-29d4-438b-a40c-1d4105134462”). |
| status | string | Status of the media (e.g., “media_created”). |
| data | object | |
| - data.allow | array | List of allowed user agents (e.g., a browser user-agent string). |
| - data.defaultPolicy | string | Default policy for user agents (e.g., “deny”). |
| - data.deny | array | List of denied user agents. |
| createdAt | string (ISO 8601) | Timestamp when the event was created. |
| attempts | array | List of attempts made to deliver the webhook. |