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

# Run a DQ Job

`POST /v3/jobs/run`

## Request

- Base URL: `/rest/2.0` (relative, and the document’s source URL is not known)
- URL: `/rest/2.0/v3/jobs/run`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
  - OAuth 2
    - Client credentials
    - Token URL: `/rest/oauth/v2/token` scopes: `sys.admin`
  - OAuth 2
    - Client credentials
    - Token URL: `/rest/oauth/v2/token`
- TypeScript: <https://skmtc.dev/collibra/apis/collibra-data-governance-center-core-api/docs/v3/jobs/run/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/collibra/apis/collibra-data-governance-center-core-api.md) - [All operations](https://skmtc.dev/collibra/apis/collibra-data-governance-center-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/collibra/apis/collibra-data-governance-center-core-api/revisions/6d091bc86a33?raw)