> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs

> Manage hosted extractor jobs in Cognite Data Fusion (CDF).

Jobs represent running hosted extractor processes that move data from sources to destinations. Each job links a source to a destination and applies a format to transform the data. You can create, monitor, update, and delete jobs. The API also provides access to job logs and metrics for monitoring extraction health.

## What jobs are

A job connects a source (`sourceId`) to a destination (`destinationId`) and applies a `format` that controls how incoming data is converted before writing to CDF. The format is required and can be a built-in type (`cognite`, `rockwell`, `value`, `sparkplug`) or `custom`, which references a [mapping](/api-reference/concepts/20230101/hosted-extractors-mappings) by `mappingId`.

<Note>
  A mapping is required only when you use the `custom` format.
</Note>

MQTT, Kafka, Event Hub, and MQTT broker jobs run continuously. REST jobs run on a fixed polling interval configured on the job.

## Job lifecycle

* **Create**: Specify a source, destination, format, and any source-specific config (such as a topic filter for MQTT or a path and interval for REST).
* **Monitor**: Check the job's `status` field, which reflects its current observed state (for example, `running`, `connected`, `connection_error`, `transform_error`). See [Hosted extractors overview — Jobs](/cdf/integration/guides/extraction/hosted_extractors#jobs) for the full list of states and what each one means.
* **Update**: Modify the source, destination, format, source-specific config, or set `targetStatus` to `running` or `paused` to start or pause the job.
* **Delete**: Remove the job when extraction is no longer required.

<Info>
  Use job logs and metrics to detect failures, diagnose connectivity issues, and ensure data is flowing correctly.
</Info>

## Monitoring extraction

The API provides endpoints to retrieve job logs and metrics. Use these to identify errors and troubleshoot problems with sources or destinations.
