API
Get an API keyTry it

Show cronjob of a web hosting package

One cronjob of a web hosting package, with its last runs and what they wrote.

RReadIdempotentbetaNeeds service_webhosting
Tool
manitu_webhosting_web_cronjob_geton https://mcp.manitu.de/mcp
POST
/v1/webhosting/web/cronjob/geton https://api.manitu.de
Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns one cronjob of a web hosting package of the manitu customer account this connection works in, by site_id and cronjob_id from manitu_webhosting_web_cronjob_list: what it runs, when (schedule, next_run_at, in Europe/Berlin), how it reports - and run_list, its last runs (at most 25, newest first) with exit code, duration and what it wrote (stdout, stderr - the first 1024 characters each). For "why does my cronjob fail?": read run_list - exit code 127 is "command not found", a run stopped at runtime_seconds_max often shows exit code 9 or 137.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1
cronjob_idinteger | stringrequired

The cronjob_id from manitu_webhosting_web_cronjob_list - never guess one.

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

Result structuredContent, checked against the schema

cronjob_idintegerrequired

The cronjob - what the other cronjob tools take.

descriptionstring | nullrequired

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

statusstringrequired

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

One of active inactive
taskobjectrequired

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

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
task.commandstring | null

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

task.urlstring | null

For type url: the URL called.

task.script_pathstring | null

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

task.php_versionstring | null

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

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.

schedule_typestring | nullrequired

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

runs_per_hour_maxinteger | nullrequired

How often it runs in one hour at most.

next_run_atstring | nullrequired

When it runs next; null if inactive or never.

Format date-time
reportobjectrequired

Whom it tells about a run, and how.

report.reasonstring | nullrequired

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

One of never onerror always null
report.typestring | nullrequired

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

One of mail logfile null
report.mailobject | nullrequired

The report mail - null unless type is mail.

report.mail.recipientstring | nullrequired

Who gets the report mail.

report.mail.subjectstring | nullrequired

Its subject, with placeholders.

report.mail.bodystring | nullrequired

Its text, with placeholders.

last_runobject | nullrequired

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

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.

last_run.started_atstring | nullrequired

When it started.

Format date-time
last_run.ended_atstring | nullrequired

When it ended.

Format date-time
last_run.duration_secondsnumber | nullrequired

How long it ran.

created_atstring | nullrequired

When it was created.

Format date-time
run_listarray of objectrequired

Its last runs, newest first (at most 25) - with what it wrote.

run_list[].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.

run_list[].started_atstring | nullrequired

When it started.

Format date-time
run_list[].ended_atstring | nullrequired

When it ended.

Format date-time
run_list[].duration_secondsnumber | nullrequired

How long it ran.

run_list[].stdoutstring | nullrequired

What it wrote to standard output - the first 1024 characters.

run_list[].stderrstring | nullrequired

What it wrote to standard error - the first 1024 characters.

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
cronjob_idinteger | stringrequired

The cronjob_id from manitu_webhosting_web_cronjob_list - never guess one.

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

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

cronjob_idintegerrequired

The cronjob - what the other cronjob tools take.

descriptionstring | nullrequired

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

statusstringrequired

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

One of active inactive
taskobjectrequired

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

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
task.commandstring | null

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

task.urlstring | null

For type url: the URL called.

task.script_pathstring | null

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

task.php_versionstring | null

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

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.

schedule_typestring | nullrequired

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

runs_per_hour_maxinteger | nullrequired

How often it runs in one hour at most.

next_run_atstring | nullrequired

When it runs next; null if inactive or never.

Format date-time
reportobjectrequired

Whom it tells about a run, and how.

report.reasonstring | nullrequired

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

One of never onerror always null
report.typestring | nullrequired

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

One of mail logfile null
report.mailobject | nullrequired

The report mail - null unless type is mail.

report.mail.recipientstring | nullrequired

Who gets the report mail.

report.mail.subjectstring | nullrequired

Its subject, with placeholders.

report.mail.bodystring | nullrequired

Its text, with placeholders.

last_runobject | nullrequired

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

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.

last_run.started_atstring | nullrequired

When it started.

Format date-time
last_run.ended_atstring | nullrequired

When it ended.

Format date-time
last_run.duration_secondsnumber | nullrequired

How long it ran.

created_atstring | nullrequired

When it was created.

Format date-time
run_listarray of objectrequired

Its last runs, newest first (at most 25) - with what it wrote.

run_list[].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.

run_list[].started_atstring | nullrequired

When it started.

Format date-time
run_list[].ended_atstring | nullrequired

When it ended.

Format date-time
run_list[].duration_secondsnumber | nullrequired

How long it ran.

run_list[].stdoutstring | nullrequired

What it wrote to standard output - the first 1024 characters.

run_list[].stderrstring | nullrequired

What it wrote to standard error - the first 1024 characters.

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.