Add self-serve task

This endpoint documentation is generated directly from openapi.yaml.

Endpoint

POST /department/selfserve/tasks

Operation

Operation ID: addSelfserveTask

Add a new self-serve task. Either provide a reusable machine_type_id or a legacy department/lane/product scope.

Authentication

Security requirements:

Scheme	Scopes
BearerAuth	-

Request Body

Required: yes.

Content type: application/json

{
  "properties": {
    "buttons": {
      "default": [],
      "description": "Optional dynamic image button IDs enabled by this task.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "condition_id": {
      "nullable": true,
      "type": "integer"
    },
    "department": {
      "default": 0,
      "type": "integer"
    },
    "description": {
      "type": "string"
    },
    "dynamic_images_vehicle_type": {
      "description": "Optional vehicle type selection override for the machine UI. Integer >= 0 or null.",
      "nullable": true,
      "type": "integer"
    },
    "lane": {
      "default": 0,
      "type": "integer"
    },
    "machine_type_id": {
      "nullable": true,
      "type": "integer"
    },
    "order_priority": {
      "default": 0,
      "type": "integer"
    },
    "product": {
      "default": 0,
      "type": "integer"
    },
    "services": {
      "description": "Optional services enabled by this task. Items must be valid service enum names.",
      "items": {
        "$ref": "#/components/schemas/SelfserveLaneService"
      },
      "type": "array"
    },
    "task": {
      "type": "string"
    }
  },
  "required": [
    "task",
    "description"
  ],
  "type": "object"
}
        

Responses

Status	Description	Content Types
200	Successfully added task	application/json
400
500

Schema for response 200 (application/json):

{
  "$ref": "#/components/schemas/DepartmentSelfserveTask"
}
        

17 March 2026