---
title: "Run a DQ Job"
method: POST
path: "/v3/jobs/run"
tags: ["DQ Job API"]
---

# Run a DQ Job

`POST /v3/jobs/run`

Runs a DQ Job using pre-configured dataset definitions for a given dataset.

## Query parameters

- `dataset` string, required
- `runDate` string, date-time, required
- `runDateEnd` string, date-time
- `agentName` string

## Response `200`

Returns the identifier of the executed job

- JobDTO
  - `jobId` integer
  - `jobUuid` string, uuid
  - `agentId` integer
  - `agentUuid` string, uuid
  - `dataset` string
  - `runId` string, date-time
  - `status` string
  - `activity` string
  - `activityStatus` string
  - `cmdLine` string
  - `description` string
  - `jobException` string
  - `username` string
  - `updtTs` string, date-time
  - `pid` string
  - `remoteJobId` string
  - `notified` integer
  - `startTime` string, date-time
  - `agentJobId` integer
  - `agentJobUuid` string, uuid

## Other responses

- `400` — Error occurred when executing new job
- `404` — No agent found by the given name

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)