Cron Python SDK

Install the official Python SDK:

pip install pxxl

from pxxl import PxxlClient

pxxl = PxxlClient(api_key="pxxl_...")

Use scope=cron, scope=cronjobs, or scope=all. Read methods work with permission=read; mutations and manual triggers require permission=read_write.

Create a Job

job = pxxl.create_cron_job(
    name="cache warmer",
    schedule="*/5 * * * *",
    url="https://example.com/api/warm-cache",
    method="POST",
    timeoutSeconds=10,
    headers={"User-Agent": "Pxxl-Cron/1.0"},
)

List, Trigger, and Read Runs

jobs = pxxl.list_cron_jobs()
details = pxxl.get_cron_job(job["id"])
pxxl.trigger_cron_job(details["id"])
runs = pxxl.list_cron_job_runs(details["id"], page=1, limit=20)

Validate Inputs

pxxl.validate_cron_schedule("*/5 * * * *")
pxxl.validate_cron_url("https://example.com/job")

Pxxl accepts 5-field cron expressions, public http or https URLs, and GET, POST, PUT, PATCH, or DELETE. Private and reserved IP targets are blocked before a job is saved.

Plan Limit Errors

Use is_plan_gate_error(error) and the error’s code, limit, current, and required_plan fields to send users to the appropriate upgrade flow.

Get Started

Projects

Deploy

Regions

Storage

Database

MCP

Domains

Cron Jobs

Troubleshooting

Cron Python SDK

Create a Job

List, Trigger, and Read Runs

Validate Inputs

Plan Limit Errors

​Create a Job

​List, Trigger, and Read Runs

​Validate Inputs

​Plan Limit Errors

Create a Job

List, Trigger, and Read Runs

Validate Inputs

Plan Limit Errors