Endpoint Reference
All endpoints use base URL https://public-api.vidmob.com/v1 and require Authorization: Bearer <api-key>.
| Method | Path | Auth Scope | Description |
|---|---|---|---|
| GET | /v1/organization | (any valid key) | Get organization id and name |
| GET | /v1/permission | (any valid key) | Get API key name, expiration, scopes, org name |
| GET | /v1/workspaces | (any valid key) | List workspaces accessible to this API key |
| GET | /v1/scoring/workspace/{workspaceId}/scorecards | scoring:read | List scorecards for a workspace (filters + pagination, max perPage=20) |
| GET | /v1/scoring/scorecard/{scorecardId}/media-metadata | scoring:read | Media under a scorecard, date-filtered |
| POST | /v1/media | scoring:read_write | Register external media for scoring |
| GET | /v1/media/{mediaId}/status | scoring:read | Poll media processing/scoring status (accepts uniqueId or external id + source/version) |
| GET | /v1/scoring/media/{mediaId}/scores | scoring:read | Get scores (format=summary | detail; optional channel/source/version/consideration) |
| POST | /v1/scoring/criteria/metadata | scoring:read | Get criteria (with groups) with filters + pagination |
| GET | /v1/media/updated-scores | scoring:read | List media with updated scores since a given date |
| POST | /v1/media/aperture | aperture:read_write | Submit creatives for AI tagging |
| GET | /v1/media/aperture/{jobId} | aperture:read | Get tagging job status and download URLs |