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

# Delete workload

> delete workload. DELETE /api/v1/workloads/{workload_id}. Delete a workload from the saved workload list and block new runs. Stop streams and finish or cancel queued and active runs

ReferenceApplies to: Unified engine deployments

## Related guidance

[Addresses and access](https://docs.e6data.com/transformation/http/access.md) · [Request identity](https://docs.e6data.com/transformation/http/request-identity.md) · [Errors and recovery](https://docs.e6data.com/transformation/http/errors.md) · [Pagination and results](https://docs.e6data.com/transformation/http/results.md)


## OpenAPI

````yaml openapi/transformation.json DELETE /api/v1/workloads/{workload_id}
openapi: 3.1.0
info:
  description: >-
    HTTP contracts for the Unified engine. Requests use the connected
    deployment's access model and configured owner. Response examples are
    illustrative; inspect your engine response in your client. SQL-managed
    secrets, credentials, streaming pipelines and maintenance run through
    session operations.
  title: Laminar Unified HTTP API
  version: v1
servers:
  - url: https://engine.example.com
    description: >-
      Example engine origin. Replace it with your deployment URL and any API
      mount prefix.
security: []
paths:
  /api/v1/workloads/{workload_id}:
    delete:
      tags:
        - Workloads
      summary: delete workload
      description: >-
        delete workload. DELETE /api/v1/workloads/{workload_id}. Delete a
        workload from the saved workload list and block new runs. Stop streams
        and finish or cancel queued and active runs first. Existing run history
        and table data are kept. Requires the current expected_revision; reuse
        submission_id after a lost response.
      operationId: delete_workload
      parameters:
        - in: path
          name: workload_id
          required: true
          schema:
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Input_app_api_src_models_rs_WorkloadDeleteBody
        required: true
      responses:
        '204':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/kernel_driver_src_models_rs_WorkloadDeleteResponse
          description: Successful response.
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: Check the request fields
              schema:
                $ref: '#/components/schemas/ApiError'
          description: A rejected or failed request. Inspect error.code before retrying.
components:
  schemas:
    Input_app_api_src_models_rs_WorkloadDeleteBody:
      additionalProperties: false
      properties:
        expected_revision:
          minimum: 0
          type: integer
        submission_id:
          $ref: '#/components/schemas/Input_shared_common_src_lib_rs_SubmissionId'
      required:
        - submission_id
        - expected_revision
      type: object
    kernel_driver_src_models_rs_WorkloadDeleteResponse:
      properties:
        workload_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
      required:
        - workload_id
      type: object
    ApiError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    Input_shared_common_src_lib_rs_SubmissionId:
      format: uuid
      type: string
    shared_common_src_lib_rs_WorkloadId:
      format: uuid
      type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.