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

# Update an OTT stored job.

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

Updates the confguration data for a stored job.  A fully populated OTTStoredJob object should be passed as the request body.

## Path parameters

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

## Request body

- 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.

## Response `200`

The updated stored job.

- 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)