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

# 异步删除(POST)

> Delete multiple historic decision instances asynchronously (batch).
At least `historicDecisionInstanceIds` or `historicDecisionInstanceQuery` 
has to be provided. If both are provided then all instances matching query 
criterion and instances from the list will be deleted.



## OpenAPI

````yaml POST /history/decision-instance/delete
openapi: 3.0.2
info:
  title: ORION Platform REST API
  description: OpenApi Spec for ORION Camunda Platform REST API.
  version: 7.22.6-ee
  license:
    name: Apache License 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://{host}:{port}/{contextPath}
    description: The API server for the default process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
  - url: http://{host}:{port}/{contextPath}/engine/{engineName}
    description: The API server for a named process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
      engineName:
        default: default
  - url: '{url}'
    description: The API server with a custom url
    variables:
      url:
        default: ''
security:
  - basicAuth: []
tags:
  - name: Authorization
  - name: Batch
  - name: Condition
  - name: Decision Definition
  - name: Decision Requirements Definition
  - name: Deployment
  - name: Engine
  - name: Event Subscription
  - name: Execution
  - name: External Task
  - name: Filter
  - name: Group
  - name: Historic Activity Instance
  - name: Historic Batch
  - name: Historic Decision Definition
  - name: Historic Decision Instance
  - name: Historic Decision Requirements Definition
  - name: Historic Detail
  - name: Historic External Task Log
  - name: Historic Identity Link Log
  - name: Historic Incident
  - name: Historic Job Log
  - name: Historic Process Definition
  - name: Historic Process Instance
  - name: Historic Task Instance
  - name: Historic User Operation Log
  - name: Historic Variable Instance
  - name: History Cleanup
  - name: Identity
  - name: Incident
  - name: Job
  - name: Job Definition
  - name: Message
  - name: Metrics
  - name: Migration
  - name: Modification
  - name: Process Definition
  - name: Process Instance
  - name: Signal
  - name: Schema Log
  - name: Task
  - name: Task Attachment
  - name: Task Comment
  - name: Task Identity Link
  - name: Task Local Variable
  - name: Task Variable
  - name: Telemetry
  - name: Tenant
  - name: User
  - name: Variable Instance
  - name: Version
externalDocs:
  description: Find out more about ORION Rest API
  url: https://docs.eorion.com
paths:
  /history/decision-instance/delete:
    post:
      tags:
        - Historic Decision Instance
      summary: Delete Async (POST)
      description: >-
        Delete multiple historic decision instances asynchronously (batch).

        At least `historicDecisionInstanceIds` or
        `historicDecisionInstanceQuery` 

        has to be provided. If both are provided then all instances matching
        query 

        criterion and instances from the list will be deleted.
      operationId: deleteAsync
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteHistoricDecisionInstancesDto'
            examples:
              example-1:
                summary: POST `/history/decision-instance/delete`
                description: POST `/history/decision-instance/delete`
                value:
                  historicDecisionInstanceIds:
                    - aDecision
                    - secondDecision
                  historicDecisionInstanceQuery:
                    decisionDefinitionKey: a-definition-key
                  deleteReason: a delete reason
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchDto'
              examples:
                example-1:
                  summary: POST `/history/decision-instance/delete`
                  description: POST `/history/decision-instance/delete`
                  value:
                    id: aBatchId
                    type: aBatchType
                    totalJobs: 10
                    batchJobsPerSeed: 100
                    jobsCreated: 10
                    invocationsPerBatchJob: 1
                    seedJobDefinitionId: aSeedJobDefinitionId
                    monitorJobDefinitionId: aMonitorJobDefinitionId
                    batchJobDefinitionId: aBatchJobDefinitionId
                    suspened: false
                    tenantId: null
                    createUserId: aUser
          description: Request successful.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            Returned if some of the query parameters are invalid, i.e. neither

            `historicDecisionInstanceIds` nor `historicDecisionInstanceQuery` is

            present. See the
            [Introduction](https://docs.camunda.org/manual/7.22/reference/rest/overview/#error-handling) 

            for the error response format.
components:
  schemas:
    DeleteHistoricDecisionInstancesDto:
      type: object
      properties:
        historicDecisionInstanceIds:
          type: array
          nullable: true
          items:
            type: string
          description: A list of historic decision instance ids to delete.
        historicDecisionInstanceQuery:
          $ref: '#/components/schemas/HistoricDecisionInstanceQueryDto'
        deleteReason:
          type: string
          nullable: true
          description: A string with delete reason.
    BatchDto:
      type: object
      properties:
        id:
          type: string
          nullable: true
          description: The id of the batch.
        type:
          type: string
          nullable: true
          description: >-
            The type of the batch.

            See the [User
            Guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/batch/#creating-a-batch)

            for more information about batch types.
        totalJobs:
          type: integer
          format: int32
          nullable: true
          description: >-
            The total jobs of a batch is the number of batch execution jobs
            required to complete the batch.
        jobsCreated:
          type: integer
          format: int32
          nullable: true
          description: The number of batch execution jobs already created by the seed job.
        batchJobsPerSeed:
          type: integer
          format: int32
          nullable: true
          description: >-
            The number of batch execution jobs created per seed job invocation.

            The batch seed job is invoked until it has created all batch
            execution jobs required by the batch

            (see `totalJobs` property).
        invocationsPerBatchJob:
          type: integer
          format: int32
          nullable: true
          description: >-
            Every batch execution job invokes the command executed by the batch
            `invocationsPerBatchJob` times.

            E.g., for a process instance migration batch this specifies the
            number of process instances which are migrated per batch execution
            job.
        seedJobDefinitionId:
          type: string
          nullable: true
          description: The job definition id for the seed jobs of this batch.
        monitorJobDefinitionId:
          type: string
          nullable: true
          description: The job definition id for the monitor jobs of this batch.
        batchJobDefinitionId:
          type: string
          nullable: true
          description: The job definition id for the batch execution jobs of this batch.
        suspended:
          type: boolean
          nullable: true
          description: Indicates whether this batch is suspended or not.
        tenantId:
          type: string
          nullable: true
          description: The tenant id of the batch.
        createUserId:
          type: string
          nullable: true
          description: The id of the user that created the batch.
        startTime:
          type: string
          format: date-time
          nullable: true
          description: >-
            The time the batch was started. Default format
            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`. For further information,

            please see the [documentation]
            (https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)
        executionStartTime:
          type: string
          format: date-time
          nullable: true
          description: >-
            The time the batch execution was started, i.e., at least one batch
            job has been executed. Default

            format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`. For further information, please
            see the [documentation]

            (https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)
    ExceptionDto:
      title: ExceptionDto
      type: object
      properties:
        type:
          type: string
          nullable: true
          description: An exception class indicating the occurred error.
        message:
          type: string
          nullable: true
          description: A detailed message of the error.
        code:
          type: number
          description: >-
            The code allows your client application to identify the error in an
            automated fashion.

            You can look up the meaning of all built-in codes and learn how to
            add custom codes

            in the [User
            Guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/error-handling/#exception-codes).
    HistoricDecisionInstanceQueryDto:
      type: object
      description: >-
        A historic decision instance query which defines a list of historic
        decision instances
      properties:
        decisionInstanceId:
          type: string
          nullable: true
          description: Filter by decision instance id.
        decisionInstanceIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by decision instance ids. Must be a comma-separated list of
            decision instance ids.
        decisionDefinitionId:
          type: string
          nullable: true
          description: Filter by the decision definition the instances belongs to.
        decisionDefinitionIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by the decision definitions the instances belongs to. Must be
            a

            comma-separated list of decision definition ids.
        decisionDefinitionKey:
          type: string
          nullable: true
          description: >-
            Filter by the key of the decision definition the instances belongs
            to.
        decisionDefinitionKeyIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by the keys of the decision definition the instances belongs
            to. Must be a comma-

            separated list of decision definition keys.
        decisionDefinitionName:
          type: string
          nullable: true
          description: >-
            Filter by the name of the decision definition the instances belongs
            to.
        decisionDefinitionNameLike:
          type: string
          nullable: true
          description: >-
            Filter by the name of the decision definition the instances belongs
            to, that the parameter

            is a substring of.
        processDefinitionId:
          type: string
          nullable: true
          description: Filter by the process definition the instances belongs to.
        processDefinitionKey:
          type: string
          nullable: true
          description: >-
            Filter by the key of the process definition the instances belongs
            to.
        processInstanceId:
          type: string
          nullable: true
          description: Filter by the process instance the instances belongs to.
        caseDefinitionId:
          type: string
          nullable: true
          description: Filter by the case definition the instances belongs to.
        caseDefinitionKey:
          type: string
          nullable: true
          description: Filter by the key of the case definition the instances belongs to.
        caseInstanceId:
          type: string
          nullable: true
          description: Filter by the case instance the instances belongs to.
        activityIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: |-
            Filter by the activity ids the instances belongs to.
            Must be a comma-separated list of acitvity ids.
        activityInstanceIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: |-
            Filter by the activity instance ids the instances belongs to.
            Must be a comma-separated list of acitvity instance ids.
        tenantIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by a comma-separated list of tenant ids. A historic decision
            instance must have one

            of the given tenant ids.
        withoutTenantId:
          type: boolean
          nullable: true
          description: >-
            Only include historic decision instances that belong to no tenant.
            Value may only be

            `true`, as `false` is the default behavior.
        evaluatedBefore:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to instances that were evaluated before the given date.

            By
            [default](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/),
            the date must have the format `yyyy-MM-

            dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`.
        evaluatedAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to instances that were evaluated after the given date.

            By
            [default](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/),
            the date must have the format `yyyy-MM-

            dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`.
        userId:
          type: string
          nullable: true
          description: Restrict to instances that were evaluated by the given user.
        rootDecisionInstanceId:
          type: string
          nullable: true
          description: |-
            Restrict to instances that have a given root decision instance id.
            This also includes the decision instance with the given id.
        rootDecisionInstancesOnly:
          type: boolean
          nullable: true
          description: >-
            Restrict to instances those are the root decision instance of an
            evaluation.

            Value may only be `true`, as `false` is the default behavior.
        decisionRequirementsDefinitionId:
          type: string
          nullable: true
          description: >-
            Filter by the decision requirements definition the instances belongs
            to.
        decisionRequirementsDefinitionKey:
          type: string
          nullable: true
          description: >-
            Filter by the key of the decision requirements definition the
            instances belongs to.
        includeInputs:
          type: boolean
          nullable: true
          description: |-
            Include input values in the result.
            Value may only be `true`, as `false` is the default behavior.
        includeOutputs:
          type: boolean
          nullable: true
          description: |-
            Include output values in the result.
            Value may only be `true`, as `false` is the default behavior.
        disableBinaryFetching:
          type: boolean
          nullable: true
          description: |-
            Disables fetching of byte array input and output values.
            Value may only be `true`, as `false` is the default behavior.
        disableCustomObjectDeserialization:
          type: boolean
          nullable: true
          description: >-
            Disables deserialization of input and output values that are custom
            objects.

            Value may only be `true`, as `false` is the default behavior.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````