Lets you upload single media asset for scoring against your criteria.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Registers an externally hosted media asset with Vidmob and queues it for AI-powered scoring. Returns a uniqueId (UUID) that permanently identifies the asset — store it for all subsequent status and scoring calls.
Required fields
| Field | Description |
|---|---|
id | Your client-side identifier for this asset. Must be unique within your org (combined with version and source). |
url | A direct, publicly accessible download URL. See URL requirements below. |
Deduplication
The combination of id + version + source is your uniqueness key. Submitting the same combination a second time returns the existing asset's uniqueId — Vidmob won't re-ingest or re-score the same media twice.
To intentionally re-score an asset against updated guidelines, increment the version field.
URL requirements
The url must be a direct download link — not a landing page, redirect chain, or auth-gated URL. Silent failures can occur if Vidmob's pipeline can't access the file. These work reliably:
- S3 presigned URLs
- CDN direct links (CloudFront, Fastly, etc.)
drive.usercontent.google.comdirect export links
workspaceId effects
Providing a workspaceId does two things:
- The asset becomes visible inside the Vidmob platform (ACS) for that workspace's users
- Workspace-specific scoring guidelines are applied on top of org-global defaults
Omit it to apply only org-global guidelines (asset won't be visible in ACS).
What comes next
After submission, poll GET /v1/media/{uniqueId}/status every 10–15 minutes. Scoring is a multi-stage pipeline — once status is COMPLETE, call GET /v1/scoring/media/{uniqueId}/scores to retrieve results.