---
title: "cancel a job execution, remove a finished job"
method: DELETE
path: "/jobs/{jobID}"
tags: ["Jobs"]
---

# cancel a job execution, remove a finished job

`DELETE /jobs/{jobID}`

Cancel a job execution and remove it from the jobs list.

For more information, see [Section 14]https://docs.ogc.org/is/18-062r2/18-062r2.html#Dismiss).

## Path parameters

- `jobID` string, required

## Response `200`

The status of a job.

- StatusInfo
  - `title` string
  - `description` string
  - `keywords` string[]
  - `metadata` Metadata[]
    - union
      - object
        - `href` string, required — Supplies the URI to a remote resource (or resource fragment).
        - `rel` string, required — The type or semantics of the relation.
        - `type` string — A hint indicating what the media type of the result of dereferencing the link should be.
        - `hreflang` string — A hint indicating what the language of the result of dereferencing the link should be.
        - `title` string — Used to label the destination of a link such that it can be used as a human-readable identifier.
        - `length` integer
        - `role` string
      - object
        - `role` string
        - `title` string
        - `lang` string
        - `value` union
          - string
          - object
  - `id` string, required
  - `processID` string, uri
  - `processingEntityType` union, required — The type of entity that created the job and is doing the processing. This includes all the data access apis listed in "apis.yaml" plus the processing APIs of OGC API Processes and OpenEO.
    - 'ogc-api-features' | 'ogc-api-coverages' | 'ogc-api-edr' | 'ogc-api-tiles' | 'ogc-api-moving-features' | 'ogc-api-sensor-things' | 'ogc-api-records' | 'ogc-api-dggs' | 'stac-api' — A non-exhaustive list of OGC and other data access APIs. This list can be extended as required.
    - 'ogc-api-processes' | 'openeo'
  - `profileEntityType` union — The type of entity requesting this status information. This may be differernt than the processing entity. For example, the processing entity may be OGC API Processes but the status information is requested via the OpenEO API.
    - 'ogc-api-features' | 'ogc-api-coverages' | 'ogc-api-edr' | 'ogc-api-tiles' | 'ogc-api-moving-features' | 'ogc-api-sensor-things' | 'ogc-api-records' | 'ogc-api-dggs' | 'stac-api' — A non-exhaustive list of OGC and other data access APIs. This list can be extended as required.
    - 'ogc-api-processes' | 'openeo'
  - `request` union
    - string
    - object
    - Link
      - `href` string, required — Supplies the URI to a remote resource (or resource fragment).
      - `rel` string, required — The type or semantics of the relation.
      - `type` string — A hint indicating what the media type of the result of dereferencing the link should be.
      - `hreflang` string — A hint indicating what the language of the result of dereferencing the link should be.
      - `title` string — Used to label the destination of a link such that it can be used as a human-readable identifier.
      - `length` integer
  - `status` 'accepted' | 'running' | 'successful' | 'failed' | 'dismissed', required
  - `message` string
  - `exception` Exception — JSON schema for exceptions based on RFC 7807
    - `type` string, required
    - `title` string
    - `status` integer
    - `detail` string
    - `instance` string
  - `created` string, date-time
  - `started` string, date-time
  - `finished` string, date-time
  - `updated` string, date-time
  - `progress` integer
  - `links` Link[]
    - `href` string, required — Supplies the URI to a remote resource (or resource fragment).
    - `rel` string, required — The type or semantics of the relation.
    - `type` string — A hint indicating what the media type of the result of dereferencing the link should be.
    - `hreflang` string — A hint indicating what the language of the result of dereferencing the link should be.
    - `title` string — Used to label the destination of a link such that it can be used as a human-readable identifier.
    - `length` integer

## Other responses

- `404` — The requested resource does not exist on the server. For example, a path parameter had an incorrect value.
- `500` — A server error occurred.

---

[API](https://skmtc.net/georust/apis/ogc-api.md) · [All operations](https://skmtc.net/georust/apis/ogc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/georust/ogc-api/versions/6c6280a034b9/schema)