# submit test task

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /srv/v1/hello:
    post:
      summary: submit test task
      deprecated: false
      description: >-
        Besides the function test (`POST /srv/v1/ping`) the task submission and
        execution can be verified by invoking `POST /srv/v1/hello`. This
        endpoint schedules a simple "Hello World" compute task verifying the
        correct configuration of OCI with respect to:


        - compute resource configuration,

        - compute resource usage authentication.

        - Bidirectional ROCKIT Edge - ROCKIT Engine communication
      tags:
        - ROCKIT Edge - Admin API/Installation / Upgrade
      parameters:
        - name: x-rockit-admin-token
          in: header
          description: ''
          required: true
          example: '{{EDGE_ADMIN_TOKEN}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Any test string to be posted as Slack message.
                relay:
                  type: boolean
                  description: >-
                    If set to `true` a second hello task will also be submitted
                    to the ROCKIT Engine.
                maintenance:
                  type: boolean
                  description: >-
                    **For debugging only.** Keep this value to `false` to avoid
                    **resource usage costs**!

                    If set to `true` the compute VM and block storage will not
                    terminate automatically in order to allow for interactive
                    logins.
              required:
                - message
                - maintenance
              x-apidog-orders:
                - message
                - relay
                - maintenance
              x-apidog-ignore-properties: []
            example:
              message: hello
              maintenance: false
              relay: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Indicates that the test task submission was successful.
                  message:
                    type: string
                    description: >-
                      Provides a confirmation note, verifying that the task
                      submission has been processed correctly.
                required:
                  - status
                  - message
                x-apidog-orders:
                  - status
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: OK
        '400':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                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:
                  - 01JQNJ5437HX89CSDFA7XFCBWM
                required:
                  - status
                  - error
                  - message
                  - detail
                x-apidog-refs:
                  01JQNJ5437HX89CSDFA7XFCBWM:
                    $ref: '#/components/schemas/Invalid%20Param'
                x-apidog-ignore-properties:
                  - status
                  - error
                  - message
                  - detail
          headers: {}
          x-apidog-name: Invalid Param
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Reflects that the request was rejected due to
                      authentication issues, typically because the provided
                      admin token is missing or invalid.
                  error:
                    type: string
                    description: >-
                      Specifies the error type (usually "unauthorized")
                      highlighting that the authentication process failed.
                  message:
                    type: string
                    description: >-
                      Offers further details about the failure (for example,
                      "invalid token"), assisting in diagnosing the
                      authorization issue.
                required:
                  - status
                  - error
                  - message
                x-apidog-orders:
                  - status
                  - error
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Unauthorized
      security: []
      x-apidog-folder: ROCKIT Edge - Admin API/Installation / Upgrade
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/732774/apis/api-11591048-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: ''
  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: []

```