Request params

Field	Type	Required	Description
`media_id`	string (UUID)	Yes	Path parameter. Identifier of the mixed media object.

No request body is required.

Response `202 Accepted`

Field	Type	Description
`detail`	string	Confirmation message. Always `"AOI detection started"`.

AOI detection runs asynchronously. Poll GET /predict/v2/mixed-media/{media_id}/aois/status until aoi_status is done or failed.

If detection is already in progress (aoi_status is started), the endpoint still returns 202 with the same message and does not start a duplicate job.

Other responses

Status	Description
400 Bad Request	The media exists but is not mixed media. Response body: `{"detail": "Media is not mixed media"}`.
404 Not Found	No media with this `media_id` exists for your company.

Example request

POST /predict/v2/mixed-media/036d5cb3-4fb1-4e88-98e6-1854b607d296/aois/detect
X-API-Key: {your_api_key}

Example response

{
  "detail": "AOI detection started"
}

Typical workflow

Create and predict mixed media — complete Create Mixed Media (or Create VAST Mixed Media) and Predict Mixed Media until prediction status is done.
Detect AOIs — POST /predict/v2/mixed-media/{media_id}/aois/detect (this endpoint).
Poll AOI status — GET /predict/v2/mixed-media/{media_id}/aois/status until aoi_status is done.
Optionally update AOIs with custom regions via PUT /predict/v2/mixed-media/{media_id}/aois, or use detected AOIs from GET /predict/v2/media/{media_id}.

202Accepted

400Bad Request

401Unauthorized

404Not Found

412Precondition Failed

422Unprocessable Content

500Internal Server Error

502Bad Gateway