---
title: "bmc job delete"
method: DELETE
path: "/v1/bmc/jobs/{jids}"
tags: ["v1", "bmc"]
---

# bmc job delete

`DELETE /v1/bmc/jobs/{jids}`

## Request

- Base URL: `https://127.0.0.1:8080`
- URL: `https://127.0.0.1:8080/v1/bmc/jobs/{jids}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/ubccr/apis/grendel-api/docs/v1/bmc/jobs/:jids/delete.ts> (a function with typed inputs; its response is checked against the schema)

#### Controller: 

`github.com/ubccr/grendel/internal/api.(*Handler).BmcJobDelete`

#### Middlewares:

- `github.com/go-fuego/fuego.defaultLogger.middleware`
- `github.com/ubccr/grendel/internal/api.(*Handler).authMiddleware`

---

Delete redfish jobs from node(s) by JID

## Path parameters

- `jids` string, required

## Query parameters

- `nodeset` string
- `tags` string

## Headers

- `Accept` string

## Response `200`

OK

- JobMessage[]
  - `data` string
  - `host` string
  - `msg` string
  - `redfish_error` object
    - `code` string
    - `error` object
      - `@Message.ExtendedInfo` object[], nullable
        - `Message` string
        - `MessageArgs.@odata.count` integer
        - `MessageId` string
        - `RelatedProperties.@odata.count` integer
        - `Resolution` string
        - `Severity` string
      - `code` string
      - `message` string
  - `status` string

## Other responses

- `default`: Default Error

## Changes

- **2025-10-28** `12410be95557`: 2 info
  - added the optional property `items/data` to the response with the `200` status (media type: application/json)
  - added the optional property `items/data` to the response with the `200` status (media type: application/xml)
- **2025-03-24** `9e09e176e964`: 1 info
  - endpoint added
- **2024-12-03** `29c6a9c3f49b`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/ubccr/apis/grendel-api/changes/v1/bmc/jobs/:jids/delete.md)

---

[API](https://skmtc.dev/ubccr/apis/grendel-api.md) - [All operations](https://skmtc.dev/ubccr/apis/grendel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubccr/apis/grendel-api/revisions/9501a911a722?raw)