# MediaMagic API

## Docs

- [Health Check](https://docs.mediamagic-lite.northell.io/api-reference/health-check.md): Return a simple health status.
- [Fire Sandbox Event](https://docs.mediamagic-lite.northell.io/api-reference/sandbox/fire-sandbox-event.md): Trigger a synthetic webhook event without running a real submission.
- [Create Submission](https://docs.mediamagic-lite.northell.io/api-reference/submissions/create-submission.md): Create a submission from one or more pre-uploaded assets.
- [Get Asset Issues](https://docs.mediamagic-lite.northell.io/api-reference/submissions/get-asset-issues.md): Get all issues for a single asset, enriched with blob-stored detail.
- [Get Asset Result](https://docs.mediamagic-lite.northell.io/api-reference/submissions/get-asset-result.md): Get detailed results for a single asset within a submission.
- [Get Asset Topics](https://docs.mediamagic-lite.northell.io/api-reference/submissions/get-asset-topics.md): Get AI-clustered topics for a single asset.
- [Get Submission Status](https://docs.mediamagic-lite.northell.io/api-reference/submissions/get-submission-status.md): Get submission processing status.
- [Get Submission Versions](https://docs.mediamagic-lite.northell.io/api-reference/submissions/get-submission-versions.md): Get all versions in the version chain for a submission.
- [Retry Asset](https://docs.mediamagic-lite.northell.io/api-reference/submissions/retry-asset.md): Retry a failed asset if its last run failed with a retryable error.
- [Direct Upload](https://docs.mediamagic-lite.northell.io/api-reference/uploads/direct-upload.md): Direct file upload through API to Azure Blob Storage.
- [Generate Upload Url](https://docs.mediamagic-lite.northell.io/api-reference/uploads/generate-upload-url.md): Generate presigned upload URL for file upload.
- [Webhook Test](https://docs.mediamagic-lite.northell.io/api-reference/webhook-test.md): Test endpoint for webhook delivery verification (no authentication required).
- [Create Subscription](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/create-subscription.md): Create a new webhook subscription.
- [Delete Subscription](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/delete-subscription.md): Delete a webhook subscription.
- [Get Subscription](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/get-subscription.md): Get a specific webhook subscription by ID.
- [List Subscription Deliveries](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/list-subscription-deliveries.md): List webhook delivery attempts for a subscription.
- [List Subscriptions](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/list-subscriptions.md): List webhook subscriptions for the authenticated workspace with pagination.
- [Update Subscription](https://docs.mediamagic-lite.northell.io/api-reference/webhooks/update-subscription.md): Update a webhook subscription (currently supports enabling/disabling).
- [Authentication](https://docs.mediamagic-lite.northell.io/authentication.md): Secure your API requests with workspace-scoped API keys
- [Assets](https://docs.mediamagic-lite.northell.io/concepts/assets.md): Learn about media assets and processing results
- [Submissions](https://docs.mediamagic-lite.northell.io/concepts/submissions.md): Understand submission lifecycle and tracking
- [Uploads](https://docs.mediamagic-lite.northell.io/concepts/uploads.md): File upload methods and best practices
- [Webhooks](https://docs.mediamagic-lite.northell.io/concepts/webhooks.md): Receive real-time event notifications for asset processing
- [Error handling guide](https://docs.mediamagic-lite.northell.io/guides/error-handling.md): Handle API errors and implement robust error recovery
- [File upload guide](https://docs.mediamagic-lite.northell.io/guides/file-upload.md): Upload files efficiently with presigned URLs and direct uploads
- [Poll status guide](https://docs.mediamagic-lite.northell.io/guides/poll-status.md): Check submission progress and retrieve results
- [Submit assets guide](https://docs.mediamagic-lite.northell.io/guides/submit-assets.md): Create submissions and manage multiple assets
- [Webhook subscriptions guide](https://docs.mediamagic-lite.northell.io/guides/webhook-subscriptions.md): Set up real-time event notifications instead of polling
- [Health Check](https://docs.mediamagic-lite.northell.io/health-check.md): Return a simple health status.
- [Introduction](https://docs.mediamagic-lite.northell.io/introduction.md): Welcome to the MediaMagic API documentation
- [Quickstart](https://docs.mediamagic-lite.northell.io/quickstart.md): Get up and running with the Integrations API in minutes
- [Error codes](https://docs.mediamagic-lite.northell.io/reference/error-codes.md): Complete reference of API error responses, status codes, and retry guidance
- [Rate limiting](https://docs.mediamagic-lite.northell.io/reference/rate-limiting.md): Understand the tier-based rate limit model and how to handle 429 responses
- [Sandbox environment](https://docs.mediamagic-lite.northell.io/reference/sandbox.md): Test your integration safely using a sandbox API key
- [Fire Sandbox Event](https://docs.mediamagic-lite.northell.io/sandbox/fire-sandbox-event.md): Trigger a synthetic webhook event without running a real submission.
- [Create Submission](https://docs.mediamagic-lite.northell.io/submissions/create-submission.md): Create a submission from one or more pre-uploaded assets.
- [Get Asset Issues](https://docs.mediamagic-lite.northell.io/submissions/get-asset-issues.md): Get all issues for a single asset, enriched with blob-stored detail.
- [Get Asset Result](https://docs.mediamagic-lite.northell.io/submissions/get-asset-result.md): Get detailed results for a single asset within a submission.
- [Get Asset Topics](https://docs.mediamagic-lite.northell.io/submissions/get-asset-topics.md): Get AI-clustered topics for a single asset.
- [Get Submission Status](https://docs.mediamagic-lite.northell.io/submissions/get-submission-status.md): Get submission processing status.
- [Get Submission Versions](https://docs.mediamagic-lite.northell.io/submissions/get-submission-versions.md): Get all versions in the version chain for a submission.
- [Retry Asset](https://docs.mediamagic-lite.northell.io/submissions/retry-asset.md): Retry a failed asset if its last run failed with a retryable error.
- [Direct Upload](https://docs.mediamagic-lite.northell.io/uploads/direct-upload.md): Direct file upload through API to Azure Blob Storage.
- [Generate Upload Url](https://docs.mediamagic-lite.northell.io/uploads/generate-upload-url.md): Generate presigned upload URL for file upload.
- [Webhook Test](https://docs.mediamagic-lite.northell.io/webhook-test.md): Test endpoint for webhook delivery verification (no authentication required).
- [Create Subscription](https://docs.mediamagic-lite.northell.io/webhooks/create-subscription.md): Create a new webhook subscription.
- [Delete Subscription](https://docs.mediamagic-lite.northell.io/webhooks/delete-subscription.md): Delete a webhook subscription.
- [Get Subscription](https://docs.mediamagic-lite.northell.io/webhooks/get-subscription.md): Get a specific webhook subscription by ID.
- [List Subscription Deliveries](https://docs.mediamagic-lite.northell.io/webhooks/list-subscription-deliveries.md): List webhook delivery attempts for a subscription.
- [List Subscriptions](https://docs.mediamagic-lite.northell.io/webhooks/list-subscriptions.md): List webhook subscriptions for the authenticated workspace with pagination.
- [Update Subscription](https://docs.mediamagic-lite.northell.io/webhooks/update-subscription.md): Update a webhook subscription (currently supports enabling/disabling).

## OpenAPI Specs

- [openapi](https://docs.mediamagic-lite.northell.io/openapi.json)