# MediaMagic API

## Docs

- [Health Check](https://docs.mediamagicverify.com/api-reference/health-check.md): Return a simple health status.
- [Asset Count Trend](https://docs.mediamagicverify.com/api-reference/insights/asset-count-trend.md): Assets created per day over the window.
- [Assets By Type](https://docs.mediamagicverify.com/api-reference/insights/assets-by-type.md): Asset distribution by file type.
- [Issues By File Type](https://docs.mediamagicverify.com/api-reference/insights/issues-by-file-type.md): Issues grouped by asset file type, with a severity breakdown.
- [Issues By Severity Trend](https://docs.mediamagicverify.com/api-reference/insights/issues-by-severity-trend.md): Issue counts by severity, per day.
- [Issues By Sidekick](https://docs.mediamagicverify.com/api-reference/insights/issues-by-sidekick.md): Issues grouped by sidekick, with a severity breakdown.
- [Pass Rate Trend](https://docs.mediamagicverify.com/api-reference/insights/pass-rate-trend.md): Share of submissions that completed with zero issues, per day.
- [Processing Duration](https://docs.mediamagicverify.com/api-reference/insights/processing-duration.md): Average and percentile processing duration (seconds).
- [Submissions By File Type Sidekick](https://docs.mediamagicverify.com/api-reference/insights/submissions-by-file-type-sidekick.md): Submission success/failure split by file type and sidekick.
- [Time Saved](https://docs.mediamagicverify.com/api-reference/insights/time-saved.md): Estimated review time saved versus a manual baseline.
- [Top Rule Violations](https://docs.mediamagicverify.com/api-reference/insights/top-rule-violations.md): Most frequently triggered rule codes, ranked by count.
- [Violation Rate Trend](https://docs.mediamagicverify.com/api-reference/insights/violation-rate-trend.md): Share of assets with at least one issue, per day.
- [Estimate submission price](https://docs.mediamagicverify.com/api-reference/pricing/estimate-submission-price.md): Preview how many credits a submission will cost, before you create it.
- [Fire Sandbox Event](https://docs.mediamagicverify.com/api-reference/sandbox/fire-sandbox-event.md): Trigger a synthetic webhook event without running a real submission.
- [List available sidekicks](https://docs.mediamagicverify.com/api-reference/sidekicks/list-available-sidekicks.md): List the sidekicks you can select on a submission.
- [Create Submission](https://docs.mediamagicverify.com/api-reference/submissions/create-submission.md): Create a submission from one or more pre-uploaded assets.
- [Get Asset Issues](https://docs.mediamagicverify.com/api-reference/submissions/get-asset-issues.md): Get all issues for a single asset, enriched with blob-stored detail.
- [Get Asset Result](https://docs.mediamagicverify.com/api-reference/submissions/get-asset-result.md): Get detailed results for a single asset within a submission.
- [Get Asset Topics](https://docs.mediamagicverify.com/api-reference/submissions/get-asset-topics.md): Get AI-clustered topics for a single asset.
- [Get Submission Status](https://docs.mediamagicverify.com/api-reference/submissions/get-submission-status.md): Get submission processing status.
- [Get Submission Versions](https://docs.mediamagicverify.com/api-reference/submissions/get-submission-versions.md): Get all versions in the version chain for a submission.
- [Retry Asset](https://docs.mediamagicverify.com/api-reference/submissions/retry-asset.md): Retry a failed asset if its last run failed with a retryable error.
- [Generate Upload Url](https://docs.mediamagicverify.com/api-reference/uploads/generate-upload-url.md): Generate presigned upload URL for file upload.
- [Create Subscription](https://docs.mediamagicverify.com/api-reference/webhooks/create-subscription.md): Create a new webhook subscription.
- [Delete Subscription](https://docs.mediamagicverify.com/api-reference/webhooks/delete-subscription.md): Delete a webhook subscription.
- [Get Subscription](https://docs.mediamagicverify.com/api-reference/webhooks/get-subscription.md): Get a specific webhook subscription by ID.
- [List Subscription Deliveries](https://docs.mediamagicverify.com/api-reference/webhooks/list-subscription-deliveries.md): List webhook delivery attempts for a subscription.
- [List Subscriptions](https://docs.mediamagicverify.com/api-reference/webhooks/list-subscriptions.md): List webhook subscriptions for the authenticated workspace with pagination.
- [Update Subscription](https://docs.mediamagicverify.com/api-reference/webhooks/update-subscription.md): Update a webhook subscription (enable/disable and/or endpoint URL).
- [Authentication](https://docs.mediamagicverify.com/authentication.md): Secure your API requests with workspace-scoped API keys
- [Assets](https://docs.mediamagicverify.com/concepts/assets.md): Learn about media assets and processing results
- [Insights](https://docs.mediamagicverify.com/concepts/insights.md): Workspace telemetry: asset, issue, submission, and processing metrics
- [Submissions](https://docs.mediamagicverify.com/concepts/submissions.md): Understand submission lifecycle and tracking
- [Uploads](https://docs.mediamagicverify.com/concepts/uploads.md): File upload method and best practices
- [Webhooks](https://docs.mediamagicverify.com/concepts/webhooks.md): Receive real-time event notifications for asset processing
- [Error handling guide](https://docs.mediamagicverify.com/guides/error-handling.md): Handle API errors and implement robust error recovery
- [File upload guide](https://docs.mediamagicverify.com/guides/file-upload.md): Upload files efficiently with presigned URLs
- [Poll status guide](https://docs.mediamagicverify.com/guides/poll-status.md): Check submission progress and retrieve results
- [Submit assets guide](https://docs.mediamagicverify.com/guides/submit-assets.md): Create submissions and manage multiple assets
- [Webhook subscriptions guide](https://docs.mediamagicverify.com/guides/webhook-subscriptions.md): Set up real-time event notifications instead of polling
- [Health Check](https://docs.mediamagicverify.com/health-check.md): Return a simple health status.
- [Asset Count Trend](https://docs.mediamagicverify.com/insights/asset-count.md): Assets created per day over the window.
- [Assets By Type](https://docs.mediamagicverify.com/insights/assets-by-type.md): Asset distribution by file type.
- [Issues By File Type](https://docs.mediamagicverify.com/insights/issues-by-file-type.md): Issues grouped by asset file type, with a severity breakdown.
- [Issues By Severity Trend](https://docs.mediamagicverify.com/insights/issues-by-severity.md): Issue counts by severity, per day.
- [Issues By Sidekick](https://docs.mediamagicverify.com/insights/issues-by-sidekick.md): Issues grouped by sidekick, with a severity breakdown.
- [Pass Rate Trend](https://docs.mediamagicverify.com/insights/pass-rate.md): Share of submissions that completed with zero issues, per day.
- [Processing Duration](https://docs.mediamagicverify.com/insights/processing-duration.md): Average and percentile processing duration (seconds).
- [Submissions By File Type Sidekick](https://docs.mediamagicverify.com/insights/submissions-by-type-sidekick.md): Submission success/failure split by file type and sidekick.
- [Time Saved](https://docs.mediamagicverify.com/insights/time-saved.md): Estimated review time saved versus a manual baseline.
- [Top Rule Violations](https://docs.mediamagicverify.com/insights/top-violations.md): Most frequently triggered rule codes, ranked by count.
- [Violation Rate Trend](https://docs.mediamagicverify.com/insights/violation-rate.md): Share of assets with at least one issue, per day.
- [Introduction](https://docs.mediamagicverify.com/introduction.md): Welcome to the MediaMagic API documentation
- [Estimate submission price](https://docs.mediamagicverify.com/pricing/estimate.md): Preview how many credits a submission will cost, before you create it.
- [Quickstart](https://docs.mediamagicverify.com/quickstart.md): Get up and running with the Integrations API in minutes
- [Error codes](https://docs.mediamagicverify.com/reference/error-codes.md): Complete reference of API error responses, status codes, and retry guidance
- [Rate limiting](https://docs.mediamagicverify.com/reference/rate-limiting.md): Understand the tier-based rate limit model and how to handle 429 responses
- [Sandbox environment](https://docs.mediamagicverify.com/reference/sandbox.md): Test your integration safely using a sandbox API key
- [Fire Sandbox Event](https://docs.mediamagicverify.com/sandbox/fire-sandbox-event.md): Trigger a synthetic webhook event without running a real submission.
- [List available sidekicks](https://docs.mediamagicverify.com/sidekicks/list-sidekicks.md): List the sidekicks you can select on a submission.
- [Create Submission](https://docs.mediamagicverify.com/submissions/create-submission.md): Create a submission from one or more pre-uploaded assets.
- [Get Asset Issues](https://docs.mediamagicverify.com/submissions/get-asset-issues.md): Get all issues for a single asset, enriched with blob-stored detail.
- [Get Asset Result](https://docs.mediamagicverify.com/submissions/get-asset-result.md): Get detailed results for a single asset within a submission.
- [Get Asset Topics](https://docs.mediamagicverify.com/submissions/get-asset-topics.md): Get AI-clustered topics for a single asset.
- [Get Submission Status](https://docs.mediamagicverify.com/submissions/get-submission-status.md): Get submission processing status.
- [Get Submission Versions](https://docs.mediamagicverify.com/submissions/get-submission-versions.md): Get all versions in the version chain for a submission.
- [Retry Asset](https://docs.mediamagicverify.com/submissions/retry-asset.md): Retry a failed asset if its last run failed with a retryable error.
- [Generate Upload Url](https://docs.mediamagicverify.com/uploads/generate-upload-url.md): Generate presigned upload URL for file upload.
- [Create Subscription](https://docs.mediamagicverify.com/webhooks/create-subscription.md): Create a new webhook subscription.
- [Delete Subscription](https://docs.mediamagicverify.com/webhooks/delete-subscription.md): Delete a webhook subscription.
- [Get Subscription](https://docs.mediamagicverify.com/webhooks/get-subscription.md): Get a specific webhook subscription by ID.
- [List Subscription Deliveries](https://docs.mediamagicverify.com/webhooks/list-subscription-deliveries.md): List webhook delivery attempts for a subscription.
- [List Subscriptions](https://docs.mediamagicverify.com/webhooks/list-subscriptions.md): List webhook subscriptions for the authenticated workspace with pagination.
- [Update Subscription](https://docs.mediamagicverify.com/webhooks/update-subscription.md): Update a webhook subscription (enable/disable and/or endpoint URL).

## OpenAPI Specs

- [openapi](https://docs.mediamagicverify.com/openapi.json)