For the complete documentation index, see llms.txt. This page is also available as Markdown.

Jobs

Search jobs

get

Returns only jobs that user has permission to view. Results are sorted by last updated timestamp in descending order.

Permissions

  • Required: DATA_QUALITY and DATA_QUALITY_JOB_VIEW

  • Global bypass:

    • DATA_QUALITY and VIEW_PERMISSIONS_VIEW_ALL

    • DATA_QUALITY and RESOURCE_MANAGE_ALL

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Query parameters
jobNamestring · max: 255Optional

Fuzzy, case-insensitive name filter. Uses SQL LIKE semantics: %jobName% Blank or omitted returns all jobs

Default: ""Example: public.nyse
edgeSiteNamestring · max: 255Optional

Edge Site Name

Example: k8s-edge-site-1
edgeConnectionNamestring · max: 255Optional

Edge connection name

Example: Finance-Postgres-GCP
dataSourceNamestring · max: 255Optional

Data source (database/catalog) name

Example: postgres
schemaNamestring · max: 255Optional

Filter by schema name

Example: public
tableNamestring · max: 255Optional

Filter by table or view name

Example: nyse
jobTypestringOptional

Execution mode for Data Quality job. Pullup jobs are available only when the Pullup preview feature is enabled. Allowed values: "PUSHDOWN", "PULLUP".

Example: PUSHDOWN
limitinteger · max: 500Optional

Number of results per page

Default: 100Example: 100
offsetintegerOptional

Result offset

Default: 0Example: 0
Responses
200

Successfully retrieved jobs

application/json

Paged list of jobs

totalinteger · int64Optional

Total number of matching items.

Example: 237
offsetinteger · int64Optional

Current offset.

Example: 0
limitinteger · int64Optional

Page size.

Example: 100
get/jobs

Create and optionally run a job

post

Creates a job and immediately queues a run. This endpoint is asynchronous: it returns a run receipt with identifiers

Permissions

  • Required: DATA_QUALITY and DATA_QUALITY_JOB_CREATE

  • Global bypass:

    • DATA_QUALITY and RESOURCE_MANAGE_ALL

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Body
queueRunbooleanOptional

Indicates whether the created job should be queued to run immediately after creation.

Currently queueRun will always treated as true, whether the client provides a value or omits the field. Create-only behavior is not supported yet. In future versions, this field will become fully optional and will default to false.

Default: true
jobNamestring · min: 1 · max: 255Optional

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
jobTypestringRequired

Execution mode for Data Quality job. Pullup jobs are available only when the Pullup preview feature is enabled. Allowed values: "PUSHDOWN", "PULLUP".

Example: PUSHDOWN
sourceQuerystring · nullableOptional

Source SQL for the job.

  • If you want to limit the data slice by date/time, do not hard-code literal dates in the SQL. Always use the placeholders ${rd} (start) and ${rdEnd} (exclusive end), and pass the actual values via the runDate / runDateEnd fields of the request.
    Example pattern: WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
  • The engine will substitute ${rd} / ${rdEnd} based on your chosen dateFormat (DATE or TIMESTAMP).
  • Keep the placeholders inside single quotes in SQL (e.g. '${rd}').
  • If you do not include a date predicate, the job will scan the full table (or whatever the query returns).
  • If omitted, the platform will generate a default(vendor compatible) SELECT * FROM "<schema>"."<table>"
Example: SELECT * FROM "public"."nyse" WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
runDateall of · nullableOptional
anyOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

or
and
anyOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

Optional. May be omitted or set to null. If not provided, the system will use the current date/time as the run date.

runDateEndone of · nullableOptional

Exclusive end of the time slice, used only when the sourceQuery contains the ${rdEnd} placeholder. Must be greater than runDate when both are provided. Formatted per jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rdEnd}, this value does not restrict the data scan and is ignored for run timing.

or
schedulingSettingsall of · nullableOptional
any · nullableOptional

Controls when a scheduled job runs and how runDate is adjusted. Exactly one schedule mode is allowed. Optional If omitted or null, the job will not be scheduled.

Example: {"daily":{"summary":"Weekdays at 04:00 am UTC, no offset","value":{"isActive":true,"scheduledRunTime":"04:00:00","schedulerMode":"DAILY","daily":{"dailyOffset":"SCHEDULED","daysOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY"]}}}}
or
or
and
anyOptional

Controls when a scheduled job runs and how the runDate is adjusted by schedule-specific offsets. The scheduler runs at the given UTC time and applies the selected mode (HOURLY/DAILY/MONTHLY).

Optional. May be omitted or set to null. If not provided, no scheduling settings will be applied.

Responses
201

Job created and run queued.

application/json

Response for job creation. Contains all fields of JobDefinition plus an optional identifier of the queued run when queueRun = true.

jobNamestring · min: 1 · max: 255Optional

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
jobTypestringOptional

Execution mode for Data Quality job. Pullup jobs are available only when the Pullup preview feature is enabled. Allowed values: "PUSHDOWN", "PULLUP".

Example: PUSHDOWN
sourceQuerystring · nullableOptional

Source SQL for the job.

  • If you want to limit the data slice by date/time, do not hard-code literal dates in the SQL. Always use the placeholders ${rd} (start) and ${rdEnd} (exclusive end), and pass the actual values via the runDate / runDateEnd fields of the request.
    Example pattern: WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
  • The engine will substitute ${rd} / ${rdEnd} based on your chosen dateFormat (DATE or TIMESTAMP).
  • Keep the placeholders inside single quotes in SQL (e.g. '${rd}').
  • If you do not include a date predicate, the job will scan the full table (or whatever the query returns).
  • If omitted, the platform will generate a default(vendor compatible) SELECT * FROM "<schema>"."<table>"
Example: SELECT * FROM "public"."nyse" WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
runDateone ofOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

or
runDateEndone of · nullableOptional

Exclusive end of the time slice, used only when the sourceQuery contains the ${rdEnd} placeholder. Must be greater than runDate when both are provided. Formatted per jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rdEnd}, this value does not restrict the data scan and is ignored for run timing.

or
schedulingSettingsone of · nullableOptional

Controls when a scheduled job runs and how runDate is adjusted. Exactly one schedule mode is allowed. Optional If omitted or null, the job will not be scheduled.

Example: {"daily":{"summary":"Weekdays at 04:00 am UTC, no offset","value":{"isActive":true,"scheduledRunTime":"04:00:00","schedulerMode":"DAILY","daily":{"dailyOffset":"SCHEDULED","daysOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY"]}}}}
or
or
jobRunIdstring · uuid · nullableOptional

Identifier of the queued job run, if the job was scheduled to run immediately after creation.

  • Present when queueRun = true and the run was successfully queued.
  • false when the job was created without an immediate run (future state).
post/jobs

Get job

get

Returns the job definition for the specified job name

Permissions

  • Required: DATA_QUALITY and DATA_QUALITY_JOB_VIEW

  • Global bypass:

    • DATA_QUALITY and VIEW_PERMISSIONS_VIEW_ALL

    • DATA_QUALITY and RESOURCE_MANAGE_ALL

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
jobNamestring · min: 1 · max: 255Required

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
Responses
200

OK

application/json
jobNamestring · min: 1 · max: 255Optional

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
jobTypestringOptional

Execution mode for Data Quality job. Pullup jobs are available only when the Pullup preview feature is enabled. Allowed values: "PUSHDOWN", "PULLUP".

Example: PUSHDOWN
sourceQuerystring · nullableOptional

Source SQL for the job.

  • If you want to limit the data slice by date/time, do not hard-code literal dates in the SQL. Always use the placeholders ${rd} (start) and ${rdEnd} (exclusive end), and pass the actual values via the runDate / runDateEnd fields of the request.
    Example pattern: WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
  • The engine will substitute ${rd} / ${rdEnd} based on your chosen dateFormat (DATE or TIMESTAMP).
  • Keep the placeholders inside single quotes in SQL (e.g. '${rd}').
  • If you do not include a date predicate, the job will scan the full table (or whatever the query returns).
  • If omitted, the platform will generate a default(vendor compatible) SELECT * FROM "<schema>"."<table>"
Example: SELECT * FROM "public"."nyse" WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
runDateone ofOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

or
runDateEndone of · nullableOptional

Exclusive end of the time slice, used only when the sourceQuery contains the ${rdEnd} placeholder. Must be greater than runDate when both are provided. Formatted per jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rdEnd}, this value does not restrict the data scan and is ignored for run timing.

or
schedulingSettingsone of · nullableOptional

Controls when a scheduled job runs and how runDate is adjusted. Exactly one schedule mode is allowed. Optional If omitted or null, the job will not be scheduled.

Example: {"daily":{"summary":"Weekdays at 04:00 am UTC, no offset","value":{"isActive":true,"scheduledRunTime":"04:00:00","schedulerMode":"DAILY","daily":{"dailyOffset":"SCHEDULED","daysOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY"]}}}}
or
or
get/jobs/{jobName}

Delete job

delete

Deletes job identified by the given job name.

Permissions

  • Required: DATA_QUALITY and DATA_QUALITY_JOB_DELETE

  • Global bypass:

    • DATA_QUALITY and RESOURCE_MANAGE_ALL

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
jobNamestring · min: 1 · max: 255Required

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
Responses
204

Job successfully deleted

No content

delete/jobs/{jobName}

No content

Update job

patch

Update existing job definition. Include only the fields you wish to update, omitted fields will remain unchanged.

Permissions

  • Required: DATA_QUALITY and DATA_QUALITY_JOB_EDIT

  • Global bypass:

    • DATA_QUALITY and RESOURCE_MANAGE_ALL

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
jobNamestring · min: 1 · max: 255Required

Job name. Allowed characters by default: letters, digits, _, ., -. Configurable via the server env variable VALIDATION_PATTERN_JOB_NAME. Default pattern: ^[a-zA-Z0-9_.-]+$.

Example: crm_raw.DimAccountPattern: ^[a-zA-Z0-9_.-]+$
Body
jobNamestringOptional

The name of an existing job definition to update

sourceQuerystring · nullableOptional

Source SQL for the job.

  • If you want to limit the data slice by date/time, do not hard-code literal dates in the SQL. Always use the placeholders ${rd} (start) and ${rdEnd} (exclusive end), and pass the actual values via the runDate / runDateEnd fields of the request.
    Example pattern: WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
  • The engine will substitute ${rd} / ${rdEnd} based on your chosen dateFormat (DATE or TIMESTAMP).
  • Keep the placeholders inside single quotes in SQL (e.g. '${rd}').
  • If you do not include a date predicate, the job will scan the full table (or whatever the query returns).
  • If omitted, the platform will generate a default(vendor compatible) SELECT * FROM "<schema>"."<table>"
Example: SELECT * FROM "public"."nyse" WHERE "trade_date" >= '${rd}' AND "trade_date" < '${rdEnd}'
runDateall of · nullableOptional
anyOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

or
and
anyOptional

Start of the time slice used only when the sourceQuery contains the ${rd} placeholder. The engine substitutes ${rd} using jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rd}, this value does not restrict the data scan and only affects the run’s date (e.g., run metadata/labeling, scheduling context).

Optional. May be omitted or set to null. If not provided, no updates will be made to existing run date.

runDateEndone of · nullableOptional

Exclusive end of the time slice, used only when the sourceQuery contains the ${rdEnd} placeholder. Must be greater than runDate when both are provided. Formatted per jobSettings.dateFormat:

  • DATE → yyyy-MM-dd
  • TIMESTAMP → RFC 3339 yyyy-MM-dd'T'HH:mm:ss'Z'

If sourceQuery omits ${rdEnd}, this value does not restrict the data scan and is ignored for run timing.

or
schedulingSettingsall of · nullableOptional
any · nullableOptional

Controls when a scheduled job runs and how runDate is adjusted. Exactly one schedule mode is allowed. Optional If omitted or null, the job will not be scheduled.

Example: {"daily":{"summary":"Weekdays at 04:00 am UTC, no offset","value":{"isActive":true,"scheduledRunTime":"04:00:00","schedulerMode":"DAILY","daily":{"dailyOffset":"SCHEDULED","daysOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY"]}}}}
or
or
and
anyOptional

Controls when a scheduled job runs and how the runDate is adjusted by schedule-specific offsets. The scheduler runs at the given UTC time and applies the selected mode (HOURLY/DAILY/MONTHLY).

Optional. May be omitted or set to null. If not provided, no updates will be made to existing scheduling settings.

Responses
200

OK. Job updated successfully. No response body.

No content

patch/jobs/{jobName}

No content

Last updated

Was this helpful?