# The VOD settings document

How this Engine runs on-demand analysis: how many jobs run at once and how many are kept, how long a finished job stays, where the content and the job records live, the default lifecycle webhook and its credential, whether jobs resume on their own, and the upload cap. Stored in its own file, conf.modules/vif/vod/settings.json, beside the stream configuration and never part of it.

Endpoint: GET /persist/vod-settings
Version: 2.0.0
Security: engineBasic

## Response 200 fields (application/json):

  - `max_concurrent_jobs` (integer)
    Jobs analyzed at once; the rest queue. Default 1.

  - `max_jobs` (integer)
    Job records kept; the oldest finished job is evicted first. Default 25.

  - `job_ttl_seconds` (integer)
    How long a finished job stays before retention removes it; 0 keeps them until evicted. Default 0.

  - `content_dir` (string,null)
    The content directory jobs read from and uploads land in, relative to the Engine home unless absolute. Applies at the next Engine start.

  - `jobs_dir` (string,null)
    Where job records, results and thumbnails are stored. Applies at the next Engine start.

  - `lifecycle_webhook` (string,null)
    The default destination of every job's state changes; a job may override or turn it off.

  - `lifecycle_webhook_secret` (string,null)
    The name of the secret sent as Authorization to the default destination — and only to it.

  - `auto_resume` (boolean,null)
    Whether a job that stops for a transient reason is resumed on its own. Default true.

  - `max_upload_bytes` (integer)
    The largest upload POST /vod/files accepts; beyond it, 413. Default 10 GiB.

  - `etag` (string,null)
    Server-assigned and ignored on a write.

## Response default fields (application/problem+json):

  - `type` (string)
    URI identifying the problem type.

  - `title` (string, required)
    Short, human-readable summary of the problem type.

  - `status` (integer, required)
    The HTTP status code, repeated from the response line.

  - `detail` (string)
    Human-readable explanation specific to this occurrence.

  - `instance` (string)
    URI identifying this specific occurrence of the problem.