Oneday Docs

Quickstart

This guide creates your first job and triggers a run.

1. Get an API key

Create a key in the dashboard, then export it in your shell:

export ONEDAY_API_KEY="od_live_..."

2. Create a job

curl -X POST https://api.oneday.nya.je/v1/jobs \
  -H "Authorization: Bearer $ONEDAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "nightly-report",
    "schedule": "0 3 * * *",
    "request": { "method": "POST", "url": "https://example.com/report" }
  }'

3. Run it once

curl -X POST https://api.oneday.nya.je/v1/jobs/job_8fk2/runs \
  -H "Authorization: Bearer $ONEDAY_API_KEY"

4. Check the result

curl https://api.oneday.nya.je/v1/jobs/job_8fk2/runs \
  -H "Authorization: Bearer $ONEDAY_API_KEY"
Schedules use 5-field cron in UTC. See Configuration for time zones and retry policy.