Creates a new Creative Aperture annotation job. The job accepts a list of creative assets and an optional set of client tags, then processes them asynchronously through Vidmob's visual AI pipeline.

Returns a job_id — store it to poll for status and retrieve results.

What you're submitting

Each job contains:

• Creative assets — The media files you want annotated. Each asset requires a URL pointing to the file.
• Client tags (optional) — Your custom taxonomy labels. These are mapped onto the annotation output, letting you receive results in terms of your own categorization system rather than (or in addition to) Vidmob's standard vocabulary.

Client tags explained

Client tags are how you bring your own taxonomy into the annotation process. For example, if your organization classifies creatives as "product-forward", "lifestyle", or "testimonial", you can pass those as client tags and receive them back alongside the standard annotations. This avoids a post-processing mapping step in your own systems.

After submission

Once the job is created, use the returned job_id to poll GET /v1/creative-aperture/jobs/{jobId} for status and results. Annotation processing is asynchronous — job completion time depends on the number and length of assets submitted.

Scope required

scoring:read_write