Skip to main content
Update a cron job configuration

Tool details

FieldValue
Nameupdate_cron_job
GroupJobs

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "cron_job_id": {
      "type": "string",
      "description": "Cron job ID"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "schedule": {
      "type": "string",
      "pattern": "^(\\S+\\s+){4}\\S+$",
      "description": "New cron schedule expression"
    },
    "timezone": {
      "type": "string",
      "description": "New timezone"
    },
    "config": {
      "type": "object",
      "additionalProperties": {
        "description": "Additional structured values supplied to the tool."
      },
      "description": "New configuration"
    },
    "timeout_seconds": {
      "type": "number",
      "description": "New timeout in seconds"
    },
    "backoff_limit": {
      "type": "number",
      "description": "New backoff limit"
    },
    "concurrency_policy": {
      "type": "string",
      "enum": [
        "Allow",
        "Forbid",
        "Replace"
      ],
      "description": "New concurrency policy"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused"
      ],
      "description": "New status (active or paused)"
    }
  },
  "required": [
    "project_reference",
    "cron_job_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the update_cron_job tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Cron job identifier."
    },
    "project_id": {
      "type": "string",
      "description": "Project identifier that owns the cron job."
    },
    "environment_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Environment identifier used when scheduled runs execute."
    },
    "branch_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Branch identifier whose source snapshot the cron job uses."
    },
    "name": {
      "type": "string",
      "description": "Human-readable cron job name."
    },
    "status": {
      "type": "string",
      "description": "Lifecycle status of the cron job, such as active or paused."
    },
    "target": {
      "type": "string",
      "description": "Execution target invoked on each schedule."
    },
    "schedule": {
      "type": "string",
      "description": "Cron expression that defines when the job can run."
    },
    "timezone": {
      "type": "string",
      "description": "Timezone applied when evaluating the cron schedule."
    },
    "config": {
      "type": "object",
      "additionalProperties": {
        "description": "Additional structured values associated with this result."
      },
      "description": "Resolved configuration payload passed to scheduled executions."
    },
    "timeout_seconds": {
      "type": "number",
      "description": "Execution timeout for each scheduled run in seconds."
    },
    "backoff_limit": {
      "type": "number",
      "description": "Maximum retry count for each scheduled run."
    },
    "concurrency_policy": {
      "type": "string",
      "description": "Concurrency policy that controls overlapping scheduled runs."
    },
    "last_scheduled_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Timestamp when the cron job most recently created a run."
    },
    "last_successful_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Timestamp when the cron job most recently completed successfully."
    },
    "created_at": {
      "type": "string",
      "description": "Timestamp when the cron job was created."
    },
    "updated_at": {
      "type": "string",
      "description": "Timestamp when the cron job was last updated."
    }
  },
  "required": [
    "id",
    "project_id",
    "environment_id",
    "branch_id",
    "name",
    "status",
    "target",
    "schedule",
    "timezone",
    "config",
    "timeout_seconds",
    "backoff_limit",
    "concurrency_policy",
    "last_scheduled_at",
    "last_successful_at",
    "created_at",
    "updated_at"
  ],
  "additionalProperties": false,
  "description": "Scheduled cron job definition returned by MCP cron tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}