List cronjobs of a web hosting package

The cronjobs of one web hosting package, with their last run and the package's limits.

RReadIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_web_cronjob_liston https://mcp.manitu.de/mcp

POST

/v1/webhosting/web/cronjob/liston https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Lists the cronjobs of a web hosting package of the manitu customer account this connection works in, by its site_id from manitu_webhosting_list: for each what it runs (task: type with command, url or script_path), when (schedule as a cron expression in Europe/Berlin, next_run_at), whether and how it reports, and its last run (exit code, when, how long). The package's limits: count_max cronjobs, runs_per_hour_max runs per hour each, runtime_seconds_max per run (then it is stopped), and the PHP versions for php_script. What a run wrote: manitu_webhosting_web_cronjob_get.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

Result structuredContent, checked against the schema

cronjob_listarray of objectrequired

cronjob_list[].cronjob_idintegerrequired

The cronjob - what the other cronjob tools take.

cronjob_list[].descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

cronjob_list[].statusstringrequired

active, or inactive (switched off by the customer, kept for later).

One of active inactive

cronjob_list[].taskobjectrequired

What it runs - type, and only the field(s) that type uses.

cronjob_list[].task.typestring | nullrequired

command (a shell command), url (calls a URL), php_script (a PHP file of the package).

One of command url php_script null

cronjob_list[].task.commandstring | null

For type command: the shell command - runs as the package's user, in its root directory.

cronjob_list[].task.urlstring | null

For type url: the URL called.

cronjob_list[].task.script_pathstring | null

For type php_script: the PHP file, relative to the package.

cronjob_list[].task.php_versionstring | null

For type php_script: the PHP version (e.g. "php8.3"); null: the package's default.

cronjob_list[].schedulestring | nullrequired

When it runs - a cron expression (minute hour day-of-month month day-of-week), in Europe/Berlin. null only if what is stored cannot be read.

cronjob_list[].schedule_typestring | nullrequired

How the customer panel shows the schedule: minutely, hourly, daily, weekly, monthly, yearly, or crontab (anything else).

cronjob_list[].runs_per_hour_maxinteger | nullrequired

How often it runs in one hour at most.

cronjob_list[].next_run_atstring | nullrequired

When it runs next; null if inactive or never.

Format date-time

cronjob_list[].reportobjectrequired

Whom it tells about a run, and how.

cronjob_list[].report.reasonstring | nullrequired

When the customer is told about a run: never, onerror (exit code not 0), always.

One of never onerror always null

cronjob_list[].report.typestring | nullrequired

How: mail, or logfile (a line in logs/cron.log of the package).

One of mail logfile null

cronjob_list[].report.mailobject | nullrequired

The report mail - null unless type is mail.

cronjob_list[].report.mail.recipientstring | nullrequired

Who gets the report mail.

cronjob_list[].report.mail.subjectstring | nullrequired

Its subject, with placeholders.

cronjob_list[].report.mail.bodystring | nullrequired

Its text, with placeholders.

cronjob_list[].last_runobject | nullrequired

Its last run; null if it has not run yet.

cronjob_list[].last_run.exit_codeinteger | nullrequired

Its exit code - 0 is success, 127 "command not found"; a run stopped at the time limit often shows 9 or 137.

cronjob_list[].last_run.started_atstring | nullrequired

When it started.

Format date-time

cronjob_list[].last_run.ended_atstring | nullrequired

When it ended.

Format date-time

cronjob_list[].last_run.duration_secondsnumber | nullrequired

How long it ran.

cronjob_list[].created_atstring | nullrequired

When it was created.

Format date-time

count_maxinteger | nullrequired

How many cronjobs the package allows.

runs_per_hour_maxintegerrequired

How often a cronjob may run in one hour at most.

runtime_seconds_maxintegerrequired

How long a run may take - then it is stopped.

php_version_listarray of objectrequired

The PHP versions a php_script may run with.

php_version_list[].namestringrequired

What php_version takes, e.g. "php8.3".

php_version_list[].is_defaultbooleanrequired

The package's default - used when php_version is null.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

Response in `data`; the rest of the body as on every call

cronjob_listarray of objectrequired

cronjob_list[].cronjob_idintegerrequired

The cronjob - what the other cronjob tools take.

cronjob_list[].descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

cronjob_list[].statusstringrequired

active, or inactive (switched off by the customer, kept for later).

One of active inactive

cronjob_list[].taskobjectrequired

What it runs - type, and only the field(s) that type uses.

cronjob_list[].task.typestring | nullrequired

command (a shell command), url (calls a URL), php_script (a PHP file of the package).

One of command url php_script null

cronjob_list[].task.commandstring | null

For type command: the shell command - runs as the package's user, in its root directory.

cronjob_list[].task.urlstring | null

For type url: the URL called.

cronjob_list[].task.script_pathstring | null

For type php_script: the PHP file, relative to the package.

cronjob_list[].task.php_versionstring | null

For type php_script: the PHP version (e.g. "php8.3"); null: the package's default.

cronjob_list[].schedulestring | nullrequired

When it runs - a cron expression (minute hour day-of-month month day-of-week), in Europe/Berlin. null only if what is stored cannot be read.

cronjob_list[].schedule_typestring | nullrequired

How the customer panel shows the schedule: minutely, hourly, daily, weekly, monthly, yearly, or crontab (anything else).

cronjob_list[].runs_per_hour_maxinteger | nullrequired

How often it runs in one hour at most.

cronjob_list[].next_run_atstring | nullrequired

When it runs next; null if inactive or never.

Format date-time

cronjob_list[].reportobjectrequired

Whom it tells about a run, and how.

cronjob_list[].report.reasonstring | nullrequired

When the customer is told about a run: never, onerror (exit code not 0), always.

One of never onerror always null

cronjob_list[].report.typestring | nullrequired

How: mail, or logfile (a line in logs/cron.log of the package).

One of mail logfile null

cronjob_list[].report.mailobject | nullrequired

The report mail - null unless type is mail.

cronjob_list[].report.mail.recipientstring | nullrequired

Who gets the report mail.

cronjob_list[].report.mail.subjectstring | nullrequired

Its subject, with placeholders.

cronjob_list[].report.mail.bodystring | nullrequired

Its text, with placeholders.

cronjob_list[].last_runobject | nullrequired

Its last run; null if it has not run yet.

cronjob_list[].last_run.exit_codeinteger | nullrequired

Its exit code - 0 is success, 127 "command not found"; a run stopped at the time limit often shows 9 or 137.

cronjob_list[].last_run.started_atstring | nullrequired

When it started.

Format date-time

cronjob_list[].last_run.ended_atstring | nullrequired

When it ended.

Format date-time

cronjob_list[].last_run.duration_secondsnumber | nullrequired

How long it ran.

cronjob_list[].created_atstring | nullrequired

When it was created.

Format date-time

count_maxinteger | nullrequired

How many cronjobs the package allows.

runs_per_hour_maxintegerrequired

How often a cronjob may run in one hour at most.

runtime_seconds_maxintegerrequired

How long a run may take - then it is stopped.

php_version_listarray of objectrequired

The PHP versions a php_script may run with.

php_version_list[].namestringrequired

What php_version takes, e.g. "php8.3".

php_version_list[].is_defaultbooleanrequired

The package's default - used when php_version is null.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_webhosting_web_cronjob_list",
    "arguments": {
      "site_id": 12345
    }
  }
}

Result

{
  "structuredContent": {
    "cronjob_list": [
      {
        "cronjob_id": 12345,
        "description": "Example",
        "status": "active",
        "task": {
          "type": "command",
          "command": "string",
          "url": "https://www.example.com/",
          "script_path": "/web",
          "php_version": "string"
        },
        "schedule": "string",
        "schedule_type": "string",
        "runs_per_hour_max": 1,
        "next_run_at": "2026-10-23T12:00:00+02:00",
        "report": {
          "reason": "never",
          "type": "mail",
          "mail": {
            "recipient": "string",
            "subject": "string",
            "body": "string"
          }
        },
        "last_run": {
          "exit_code": 1,
          "started_at": "2026-10-23T12:00:00+02:00",
          "ended_at": "2026-10-23T12:00:00+02:00",
          "duration_seconds": 1.5
        },
        "created_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_max": 1,
    "runs_per_hour_max": 1,
    "runtime_seconds_max": 1,
    "php_version_list": [
      {
        "name": "example.com",
        "is_default": true
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/web/cronjob/list

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/web/cronjob/list' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345
  }'

const response = await fetch('https://api.manitu.de/v1/webhosting/web/cronjob/list', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "site_id": 12345
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/web/cronjob/list');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"site_id":12345}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/webhosting/web/cronjob/list",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "cronjob_list": [
      {
        "cronjob_id": 12345,
        "description": "Example",
        "status": "active",
        "task": {
          "type": "command",
          "command": "string",
          "url": "https://www.example.com/",
          "script_path": "/web",
          "php_version": "string"
        },
        "schedule": "string",
        "schedule_type": "string",
        "runs_per_hour_max": 1,
        "next_run_at": "2026-10-23T12:00:00+02:00",
        "report": {
          "reason": "never",
          "type": "mail",
          "mail": {
            "recipient": "string",
            "subject": "string",
            "body": "string"
          }
        },
        "last_run": {
          "exit_code": 1,
          "started_at": "2026-10-23T12:00:00+02:00",
          "ended_at": "2026-10-23T12:00:00+02:00",
          "duration_seconds": 1.5
        },
        "created_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_max": 1,
    "runs_per_hour_max": 1,
    "runtime_seconds_max": 1,
    "php_version_list": [
      {
        "name": "example.com",
        "is_default": true
      }
    ]
  }
}

List cronjobs of a web hosting package

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call