Media events
Upload media (Push)
Media created (Pull)
Upload media created
Media ready
Media failed
Media updated
Media deleted
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"). |
| 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). |
| created_at | 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") |
| 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.io/sample.mp4") |
| - data.subtitles | object | Subtitles associated with the media (e.g., an empty object). |
| - data.optimizeAudio | boolean | Indicates if audio optimization is enabled (e.g., false) |
| 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") |
| 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.metadata | object | Metadata associated with the media. |
| -- data.metadata.key1 | string | A key-value pair for metadata (e.g., "key1": "value1") |
| - 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") |
| created_at | 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") |
| 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.io/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.metadata | object | Metadata for the media (e.g., "key1": "value1") |
| - 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") |
| created_at | string (ISO 8601) | Timestamp when the event was created (e.g., "2025-04-07T09:30:40.636687200Z") |
| updated_at | string (ISO 8601) | Timestamp when the media was last updated (e.g., "2025-04-07T09:30:40.614230Z") |
| 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.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"). |
| 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.metadata | object | Metadata associated with the media. |
| --data.metadata.key1 | string | Key-value pair for metadata. |
| -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 for the webhook event |
| id | string | Unique identifier for the event |
| environment | object | |
| - environment.name | string | Unique identifier for the environment (e.g., "fastpix") |
| - environment.id | string | Name for the environment (e.g., "9oa85f64-5717-4562-b3fc-2c963f66afa6") |
| data | object | |
| - data.id | string | Unique identifier for the media. Max 255 characters. |
| - data.created_at | integer | |
| - data.duration | number | The duration of the media in seconds (max duration for a single media is 12 hours). |
| - data.maxresolution | string | The maximum resolution tier for the media. Default is 1080p if omitted. |
| - data.availableresolution | string | The maximum resolution tier for the media. Default is 1080p if omitted. |
| - data.encoding_tier | string | The encoding tier informs the cost, quality, and available platform features for the media. Default is smart encoding tier. |
| - data.aspect_ratio | string | The aspect ratio of the media in the form of width:height (e.g., 16:9). |
| - data.playback_ids | object | |
| -- data.playback_ids.id | string | Unique identifier for the PlaybackID (e.g., "public") |
| -- data.playback_ids[].accessPolicy | string | Access policy for playback IDs. Possible values: "public", "private", "drm". |
| - data.tracks | object | |
| -- data.tracks[].id | string | Universal unique identifier for the track. Max 255 characters. |
| -- data.tracks[].type | string | Individual media tracks that make up the media. Possible values: "video", "audio", "text". |
| -- data.tracks[].width | number | Maximum width in pixels available for the track (only for video type). |
| -- data.tracks[].height | number | Maximum height in pixels available for the track (only for video type). |
| -- data.tracks[].frameRate | number | Maximum frame rate available for the track (may return -1 if undetermined). |
| -- data.tracks[].closed_captions | string | Indicates if the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). Only for text tracks with type "subtitles". |
| - data.test | boolean | True if this live stream is a test media. Test media is watermarked, limited to 10 seconds, and deleted after 24 hours. |
| - data.status | string | The status of the media. Possible values: "created", "waiting", "preparing", "ready", "failed". |
| - data.ingest_type | string | Possible values: "on_demand_url", "on_demand_direct_upload", "on_demand_clip", "live_rtmp", "live_srt". |
| created_at | integer | Unique identifier for the webhook. |
| attempts | array | |
| accessor_source | string | |
| accessor | string |
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"). |
| 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. |
Updated about 14 hours ago