---
title: delete_job() | Tiger Data Docs
description: Delete a job from the automatic scheduler
---

Community Since [1.2.0](https://github.com/timescale/timescaledb/releases/tag/1.2.0)

Delete a job registered with the automation framework. This works for jobs as well as policies.

If the job is currently running, the process is terminated.

## Samples

Delete the job with the job id 1000:

```
SELECT delete_job(1000);
```

## Arguments

The syntax is:

```
SELECT delete_job(
    job_id = <job_id>
);
```

| Name     | Type    | Default | Required | Description                   |
| -------- | ------- | ------- | -------- | ----------------------------- |
| `job_id` | INTEGER | -       | ✔        | TimescaleDB background job id |

## Returns

This function returns void.
