# Acknowledge Warning / Expire Task

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /be/v1/tasks:
    patch:
      summary: Acknowledge Warning / Expire Task
      deprecated: false
      description: >-
        This endpoint allows you to acknowledge warnings or expire upload tasks
        in ROCKIT Edge.


        Warnings do not block execution but signal potential issues.
        Acknowledging a warning marks it as reviewed but does not fix the root
        cause. The warning will remain visible until the issue is resolved and
        the process retried.


        In addition to acknowledging warnings, this endpoint also allows you to
        expire upload tasks. Expiring a task is necessary when something goes
        wrong during the upload process—such as exceptions, failed transfers, or
        incomplete data. Expiring a task also automatically acknowledges its
        warning.


        ### Use this when:


        - You want to track which warnings have been reviewed.

        - You need to differentiate between new and previously acknowledged
        warnings.

        - An upload task failed, and you need to manually expire it to prevent
        further issues or to allow for cleanup/retry.

        ### Important:

        - Acknowledging a warning does not retry or fix the task. If the task is
        in an error state, you must correct the issue and trigger a retry where
        applicable.

        - Expiring a task marks it as failed and acknowledged, but does not
        automatically trigger a new upload—you must manually retry or restart
        the process if needed.


        ### Required Permissions


        `tasks.update`


        See [Roles](https://edge.api.cloud.rockitplay.com/roles-3618377f0.md)
        for more details.
      tags:
        - ROCKIT Edge - Backend API/Tasks
      parameters:
        - name: Authorization
          in: header
          description: >-
            Use the access token obtained from [`POST
            /be/v1/login`](https://edge.api.cloud.rockitplay.com/user-login-org-11611254e0.md)
            or [`POST
            /be/v1/refresh`](https://edge.api.cloud.rockitplay.com/refresh-11630082e0.md)
            as Bearer token. <br>Mutually excluded with `x-rockit-api-key`.
          required: true
          example: Bearer {{_edge_org_admin_access_token}}
          schema:
            type: string
        - name: x-rockit-tenant
          in: header
          description: >
            Unique and immutable tenancy identifier obtained from the ROCKIT
            Edge administrator. <br>Requires `x-rockit-username`,
            `x-rockit-orgname` and `x-rockit-api-key`.
          required: true
          example: '{{EDGE_TENANT_NAME}}'
          schema:
            type: string
        - name: x-rockit-orgname
          in: header
          description: >
            Unique and immutable organization identifier obtained from the
            ROCKIT Edge administrator. <br>Requires `x-rockit-tenant`,
            `x-rockit-username` and `x-rockit-api-key`.
          required: true
          example: '{{EDGE_ORG_NAME}}'
          schema:
            type: string
        - name: x-rockit-username
          in: header
          description: >
            Unique and immutable username which is associated with the apikey.
            <br>Requires `x-rockit-tenant`, `x-rockit-orgname` and
            `x-rockit-api-key`.
          required: true
          example: adminPrincipal
          schema:
            type: string
        - name: x-rockit-api-key
          in: header
          description: >-
            Unique and immutable apikey which is associated with an machine
            user. <br>Mutually excluded with `Authorization` header. Requires
            `x-rockit-tenant`, `x-rockit-username` and `x-rockit-orgname`.
          required: true
          example: '{{_adminPrincipal_apiKey}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Unique and immutable identifier of the task.
                  pattern: /^[A-Za-z0-9_[\]]{2,50}$/
                acknowledged:
                  type: boolean
                  description: Bool to acknowledge the warning of a specific task
                expired:
                  type: boolean
                  description: >-
                    Bool to expire a upload task. This also automaitcally
                    acknowledges the warning.
              x-apidog-orders:
                - name
                - acknowledged
                - expired
              required:
                - name
              x-apidog-ignore-properties: []
            example:
              name: exampleTaskname
              acknowledged: true
              expired: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Indicates that the request to acknowledge warnings on
                      tasks was successful.
                  totalCount:
                    type: integer
                    description: >-
                      An integer representing the total number of tasks after
                      the acknowledgment.
                  tasks:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        service:
                          type: string
                        status:
                          type: string
                      required:
                        - name
                        - service
                        - status
                      x-apidog-orders:
                        - name
                        - service
                        - status
                      x-apidog-ignore-properties: []
                    description: >-
                      An array of task summary objects (each containing key
                      details such as task name, service, and status) that
                      reflects the updated state after acknowledging warnings.
                required:
                  - status
                  - totalCount
                  - tasks
                x-apidog-orders:
                  - status
                  - totalCount
                  - tasks
                x-apidog-ignore-properties: []
              examples:
                '1':
                  summary: '200: success'
                  value:
                    status: success
                    totalCount: 13
                    tasks:
                      - name: exampleorg-sushi-0001-1732886919-dltar
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0001-1732887061-mkraw
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0001-1732887229-mkdxf
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0001-1732887357-publish
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0001-1732887364-deploy
                        service: edge
                        status: done
                      - name: exampleorg-sushi-0002-1733149403-dltar
                        service: engine
                        status: pending
                      - name: exampleorg-sushi-0002-1733154780-dltar
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0002-1733154909-mkraw
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0002-1733155066-mkpat
                        service: engine
                        status: done
                      - name: exampleorg-sushi-0002-1733155262-mkdxf
                        service: engine
                        status: done
                '2':
                  summary: '400: missing-param'
                  value:
                    status: failed
                    error: missing-param
                    message: x-rockit-beauth-token missing
                    detail: header parameter x-rockit-beauth-token is required
                '3':
                  summary: '401: token-expired'
                  value:
                    status: failed
                    error: token-expired
                    message: expired token
          headers: {}
          x-apidog-name: '200: success'
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Reflects that the creation failed due to one or more
                      invalid or missing parameters in the request.
                  error:
                    type: string
                    description: Contains an error identifier.  (e.g., "invalid-param")
                  message:
                    type: string
                    description: >-
                      Explains the nature of the invalid input (for example,
                      "name invalid").
                  detail:
                    type: string
                    description: >-
                      Offers further context on the error. (e.g., expected
                      pattern for the organization name)
                x-apidog-orders:
                  - 01JQNHWQR83MSZPT8RPNPMPWJ8
                required:
                  - status
                  - error
                  - message
                  - detail
                x-apidog-refs:
                  01JQNHWQR83MSZPT8RPNPMPWJ8:
                    $ref: '#/components/schemas/Invalid%20Param'
                x-apidog-ignore-properties:
                  - status
                  - error
                  - message
                  - detail
          headers: {}
          x-apidog-name: '400: missing-param'
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Indicates that the organization creation request was
                      rejected because of authentication problems.
                  error:
                    type: string
                    description: Contains an error identifier. (e.g."unauthorized")
                  message:
                    type: string
                    description: >-
                      Provides details such as "invalid token" to help diagnose
                      the failure.
                x-apidog-orders:
                  - 01JQNHX3WSA6XVCNKR7RD9VAG4
                required:
                  - status
                  - error
                  - message
                x-apidog-refs:
                  01JQNHX3WSA6XVCNKR7RD9VAG4:
                    $ref: '#/components/schemas/unauthorized'
                x-apidog-ignore-properties:
                  - status
                  - error
                  - message
          headers: {}
          x-apidog-name: '401: token-expired'
      security: []
      x-apidog-folder: ROCKIT Edge - Backend API/Tasks
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/732774/apis/api-13268279-run
components:
  schemas:
    Invalid Param:
      type: object
      properties:
        status:
          type: string
          description: >-
            Reflects that the creation failed due to one or more invalid or
            missing parameters in the request.
        error:
          type: string
          description: Contains an error identifier.  (e.g., "invalid-param")
        message:
          type: string
          description: >-
            Explains the nature of the invalid input (for example, "name
            invalid").
        detail:
          type: string
          description: >-
            Offers further context on the error. (e.g., expected pattern for the
            organization name)
      required:
        - status
        - error
        - message
        - detail
      x-apidog-orders:
        - status
        - error
        - message
        - detail
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    unauthorized:
      type: object
      properties:
        status:
          type: string
          description: >-
            Indicates that the organization creation request was rejected
            because of authentication problems.
        error:
          type: string
          description: Contains an error identifier. (e.g."unauthorized")
        message:
          type: string
          description: >-
            Provides details such as "invalid token" to help diagnose the
            failure.
      required:
        - status
        - error
        - message
      x-apidog-orders:
        - status
        - error
        - message
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    Bearer token:
      type: bearer
      scheme: bearer
      description: >-
        Enter your Access Token. You can obtain this by calling the /be/v1/login
        endpoint. Use the Refresh token to get a new Access token when it
        expires.
servers:
  - url: https://Example-Server.com
    description: Default
security: []

```