List Cron Jobs

{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused",
        "deleting"
      ],
      "description": "Filter by cron job status"
    },
    "environment_id": {
      "type": "string",
      "description": "Filter by environment ID"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "description": "Number of results per page (default: 20, max: 100)",
      "default": 20
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor (cron job ID) from previous response"
    }
  },
  "required": [
    "project_reference"
  ],
  "additionalProperties": false,
  "description": "Input schema for the list_cron_jobs tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "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."
          },
          "run_as_user_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Persisted user identity used when scheduled cron executions run."
          },
          "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",
          "run_as_user_id",
          "created_at",
          "updated_at"
        ],
        "additionalProperties": false,
        "description": "Scheduled cron job definition returned by MCP cron tools."
      },
      "description": "Cron job records for the requested page."
    },
    "page_info": {
      "type": "object",
      "properties": {
        "self": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor representing the current result page."
        },
        "first": {
          "type": "null",
          "description": "Always null because these job list endpoints do not expose a first-page cursor."
        },
        "next": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor for the next page of results, or null when exhausted."
        },
        "prev": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor for the previous page when available, otherwise null."
        }
      },
      "required": [
        "self",
        "first",
        "next",
        "prev"
      ],
      "additionalProperties": false,
      "description": "Pagination cursors for traversing the cron job list."
    }
  },
  "required": [
    "data",
    "page_info"
  ],
  "additionalProperties": false,
  "description": "Paginated list of scheduled cron jobs for a project.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}