---
title: "Create a job"
method: POST
path: "/v6/jobs"
tags: ["File Validation Monitors"]
---

# Create a job

`POST /v6/jobs`

Creates a file validation monitor job. Optional triggers and tasks may be supplied in the same request.

## Request body

- JobRequest
  - `enabled` boolean
  - `name` string
  - `tasks` TaskRequest[], required
    - union
      - object
        - `order` integer, required
        - `task_type` 'FILE_HEADER_VALIDATOR', required
        - `expected_headers` string[], required
        - `match_mode` 'EXACT_SET' | 'ORDERED' | 'SUBSET', required
        - `on_mismatch` 'FAIL' | 'WARN', required
      - object
        - `order` integer, required
        - `task_type` 'START_AUDIENCE_OPERATION', required
      - object
        - `order` integer, required
        - `task_type` 'START_BATCH_JOB', required
        - `data_source_type` 'AUDIENCE_LIST' | 'FILE_ASSET' | 'REPORT', required
        - `event_name` string, required
  - `triggers` TriggerRequest[], required
    - union
      - object
        - `trigger_type` 'FILE_NAME_MATCHES', required
        - `match_type` 'EXACT' | 'REGEX', required
        - `pattern` string, required
      - object
        - `trigger_type` 'LANDS_IN_DIRECTORY', required
        - `directory_path` string, required

## Response `200`

Successful response

- JobResponse
  - `client_id` string, required
  - `created_date` string, required — [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds.
  - `enabled` boolean, required
  - `id` string, required
  - `name` string, required
  - `tasks` TaskResponse[], required
    - union
      - object
        - `id` string, required
        - `order` integer, required
        - `task_type` 'FILE_HEADER_VALIDATOR', required
        - `expected_headers` string[], required
        - `match_mode` 'EXACT_SET' | 'ORDERED' | 'SUBSET', required
        - `on_mismatch` 'FAIL' | 'WARN', required
      - object
        - `id` string, required
        - `order` integer, required
        - `task_type` 'START_AUDIENCE_OPERATION', required
      - object
        - `id` string, required
        - `order` integer, required
        - `task_type` 'START_BATCH_JOB', required
        - `data_source_type` 'AUDIENCE_LIST' | 'FILE_ASSET' | 'REPORT', required
        - `event_name` string, required
  - `triggers` TriggerResponse[], required
    - union
      - object
        - `id` string, required
        - `trigger_type` 'FILE_NAME_MATCHES', required
        - `match_type` 'EXACT' | 'REGEX', required
        - `pattern` string, required
      - object
        - `id` string, required
        - `trigger_type` 'LANDS_IN_DIRECTORY', required
        - `directory_path` string, required
  - `updated_date` string, required — [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `415` — Unsupported Media Type
- `429` — Too Many Requests

---

[API](https://skmtc.net/extole/apis/integration-api-server-to-extole.md) · [All operations](https://skmtc.net/extole/apis/integration-api-server-to-extole/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extole/integration-api-server-to-extole/versions/c16e62e66755/schema)