Neuen cronjob anlegen

POST /v1/accounts/{accountIdentifier}/cronjobs/

API version

v1

Request method

POST

Operation ID

createCronjob

---

Diese Operation legt einen neuen Cronjob an

Request

• accountIdentifierstring

  required

  Name oder ID eines Accounts

Responses

Format

application/json

Description

Der angelegte Cronjob

Schema documentation

• uidinteger

  required
• namestring

  required
• enabledboolean

  required
• errorReportingstring (one of: NONE, MAIL_ON_FAILURE, MAIL)

  required
• errorReportingEmailstring

  required
• customTimeoutModenumber (one of: 0, 1)

  required

  Whether a custom timeout is set

• customTimeoutValuenumber

  Amount of custom timeout

• typestring (one of: SERVER, BROWSER, INTERPRETER)

  required

  Type of cronjob (server based, browser based, custom interpreter)

• intervalarray of string

  required

  Crontab interval

  • Array[
  • *string
  ]

statusnumber

required

filestring

paramsstring

urlstring

interpreterobject

• hiddenboolean

  required
• namestring

  required
• typestring

  required
• uidnumber

  required

Example

{
  "uid": 123,
  "name": "string",
  "enabled": true,
  "errorReporting": "NONE",
  "errorReportingEmail": "string",
  "customTimeoutMode": 123,
  "customTimeoutValue": 123,
  "type": "SERVER",
  "interval": [
    "string"
  ],
  "status": 123,
  "file": "string",
  "params": "string",
  "url": "string",
  "interpreter": {
    "hidden": true,
    "name": "string",
    "type": "string",
    "uid": 123
  }
}

JSON Schema

{
  "title": "Cronjob",
  "type": "object",
  "required": [
    "uid",
    "name",
    "enabled",
    "errorReporting",
    "errorReportingEmail",
    "customTimeoutMode",
    "type",
    "interval",
    "status"
  ],
  "properties": {
    "uid": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "errorReporting": {
      "type": "string",
      "enum": [
        "NONE",
        "MAIL_ON_FAILURE",
        "MAIL"
      ]
    },
    "errorReportingEmail": {
      "type": "string"
    },
    "customTimeoutMode": {
      "description": "Whether a custom timeout is set",
      "type": "number",
      "enum": [
        0,
        1
      ]
    },
    "customTimeoutValue": {
      "description": "Amount of custom timeout",
      "type": "number"
    },
    "type": {
      "description": "Type of cronjob (server based, browser based, custom interpreter)",
      "type": "string",
      "enum": [
        "SERVER",
        "BROWSER",
        "INTERPRETER"
      ]
    },
    "interval": {
      "description": "Crontab interval",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "status": {
      "type": "number"
    },
    "file": {
      "type": "string"
    },
    "params": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "interpreter": {
      "type": "object",
      "required": [
        "hidden",
        "name",
        "type",
        "uid"
      ],
      "properties": {
        "hidden": {
          "type": "boolean"
        },
        "name": {
          "type": "string"
        },
        "type": {
          "type": "string"
        },
        "uid": {
          "type": "number"
        }
      }
    }
  }
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -X POST \
    -d '{"customTimeoutMode":123,"customTimeoutValue":123,"enabled":true,"errorReporting":"NONE","errorReportingEmail":"string","file":"string","url":"string","interpreter":123,"interval":["string"],"name":"string","params":"string","type":"SERVER"}' \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    -H 'Content-Type: application/json' \
    https://api.mittwald.de/v1/accounts/string/cronjobs