---
title: "Get a 'generate-engagement-insights' job"
method: GET
path: "/robots/v0/jobs/generate-engagement-insights/{JOB_ID}"
tags: ["Generate Engagement Insights (v0)"]
deprecated: true
---

# Get a 'generate-engagement-insights' job

`GET /robots/v0/jobs/generate-engagement-insights/{JOB_ID}`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/robots/v0/jobs/generate-engagement-insights/{JOB_ID}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

> **Deprecated.**

Deprecated: use `GET /robots/v1/jobs/generate-engagement-insights/{job_id}` instead. Retrieves the current status and results of a 'generate-engagement-insights' job. Jobs are automatically deleted after 30 days.

## Path parameters

- `JOB_ID` string, required: Robots job ID returned by job creation or listing (rjob_...).

## Response `200`

Current status for the requested job

- GenerateEngagementInsightsJobResponseV0
  - `data` GenerateEngagementInsightsJobV0, required
    - `id` string, required: Unique job identifier.
    - `passthrough` string: Arbitrary string supplied at creation, returned as-is.
    - `units_consumed` integer, required: Number of Mux AI units consumed by this job.
    - `directive` JobDirectiveContextV0: The directive run that dispatched this job. Absent for jobs created via direct API POST.
      - `id` string, required: ID of the directive that dispatched this job.
      - `run_id` string, required: ID of the specific directive run that dispatched this job.
    - `created_at` integer, required: Unix timestamp (seconds) when the job was created.
    - `updated_at` integer, required: Unix timestamp (seconds) of the job's last state transition (e.g. when it started processing or reached a terminal state).
    - `workflow` 'generate-engagement-insights', required
    - `parameters` GenerateEngagementInsightsJobParametersV0, required
      - `asset_id` string, required: The Mux asset ID of the video to analyze engagement for.
    - `status` 'pending' | 'processing' | 'completed' | 'errored' | 'cancelled', required: Current job status.
    - `errors` JobErrorV0[]: Error details. Present when status is 'errored'.
      - `type` string, required: Stable public error category identifier.
      - `message` string, required: Human-readable public error message.
      - `retryable` boolean: Whether retrying this job may resolve the error.
    - `resources` ResourcesV0: Related Mux resources linked to this job.
      - `assets` SlimlineAssetV0[], required: Mux assets associated with this job.
        - `id` string, required: Mux asset ID.
        - `meta` object: Mux asset metadata, if available.
          - `title` string: Asset title from Mux metadata.
          - `creator_id` string: Creator identifier from Mux metadata.
          - `external_id` string: External identifier from Mux metadata.
        - `passthrough` string: Passthrough string from the Mux asset.
        - `_links` object, required: Hypermedia links for the asset.
          - `self` object, required
            - `href` string, required: URL to the Mux asset resource.
    - `outputs` GenerateEngagementInsightsJobOutputsV0: Workflow results. Present when status is 'completed'.
      - `moment_insights` object[], required: Per-moment engagement insights for identified hotspots.
        - `start_ms` number, required: Start time in milliseconds.
        - `end_ms` number, required: End time in milliseconds.
        - `engagement_score` number, required: Normalized engagement score (0-1).
        - `insight` string, required: Primary insight explaining the engagement pattern.
      - `overall_insight` object, required: Overall engagement analysis across the video.
        - `summary` string, required: Summary of overall engagement patterns.
        - `trends` string[], required: Key trends identified across the video.

## Other responses

- `401`: Missing or invalid Mux credentials
- `403`: Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access.
- `404`: No job exists for the supplied id
- `422`: Invalid job ID
- `500`: Server error

## Changes

- **2026-10-26** `151835caff06`: 1 info
  - endpoint deprecated
- **2026-10-19** `7e2e5079412d`: 3 info
  - api operation id `get-generate-engagement-insights-job` removed and replaced with `get-generate-engagement-insights-job-v0`
  - api tag `Generate Engagement Insights (v0)` added
  - api tag `Generate Engagement Insights` removed
- **2026-10-08** `296f0b01bb84`: 9 info
  - added the non-success response with the status `422`
  - added the optional property `error/messages` to the response with the `401` status
  - added the optional property `error/messages` to the response with the `403` status
  - added the optional property `error/messages` to the response with the `404` status
  - …5 more
- **2026-08-12** `5b4b3133f27d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/jobs/generate-engagement-insights/:JOB_ID/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)