---
title: "Run an OTT stored job."
method: POST
path: "/accounts/{{account_id}}/mrss/ott-stored-jobs/{job_id}/run"
tags: ["OTT Stored Jobs"]
---

# Run an OTT stored job.

`POST /accounts/{{account_id}}/mrss/ott-stored-jobs/{job_id}/run`

Request an asynchronous execution of a stored job.  No POST body is required.  If the job is already in a PENDING or PROCESSING state the request is ignored.  Call the API GET method for the job id to check the execution status and obtain the result URLs after execution is complete.  Newly generated results will overwrite previously generated results for the job.

## Path parameters

- `account_id` string, required
- `job_id` string, required

## Response `200`

Job submitted successfully.

- OTTStoredJob
  - `id` string — Id of this job
  - `name` string, required — Name of this job
  - `syndications` string[], required — A list of OTT syndication ids to be processed.
  - `auto_run_interval_hours` integer — Frequency in hours at which to automatically regenerate the job results. If not set or if set to zero, no auto-regeneration will occur but the job can still be run on demand via the /run REST API method. If a non-zero value is specified, the minimum interval is 6 hours. Newly generated results will overwrite results generated by any earlier job runs.
  - `state` 'READY' | 'PENDING' | 'PROCESSING' — State of this job. READY indicates the job is not currently in the process of being run. PENDING indicates the an API request to run the job on demand has been made but processing of the job has not yet begun. PROCESSING indicates the job is currently being run.
  - `last_run_status` 'SUCCESS' | 'ERROR' — Status of the last run attempt for this stored job.
  - `results` string[] — A list of URLs pointing to the latest set of results files. Currently this will contain just a single URL pointing to a zipped results file if the job was processed successfully. The signed URLs will expire after 3 hours, refetching the job will generate fresh URLs.
  - `public_results` string[] — If this job contained syndications that were configured with publish_results set to true, a list of URLs pointing to the latest set of public results files.
  - `errors` string[] — A list of errors that occurred if a job failed to complete successfully during its latest run.
  - `created_at` string — Job creation timestamp, in UTC format.
  - `updated_at` string — Last job update timestamp, in UTC format.
  - `last_run_at` string — Last job run timestamp, in UTC format.
  - `last_successful_run_at` string — Last successful job run timestamp, in UTC format.

## Other responses

- `401` — Insufficient permissions to access this API method
- `404` — Job not found
- `500` — Server error

---

[API](https://skmtc.net/brightcovelearning/apis/brightcove-syndication-configuration-api.md) · [All operations](https://skmtc.net/brightcovelearning/apis/brightcove-syndication-configuration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightcovelearning/brightcove-syndication-configuration-api/revisions/d7b8a38db19f/schema)