Get schedule

GET

/api/v1/schedules/{id}

curl -X GET 'https://dashboard.justcrawl.io/api/v1/schedules/sch_01ABC' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

import os, requests
r = requests.get(
    f'https://dashboard.justcrawl.io/api/v1/schedules/{schedule_id}',
    headers={'Authorization': f'Bearer {os.environ["JUSTCRAWL_API_KEY"]}'},
)
r.raise_for_status()
schedule = r.json()

const res = await fetch(`https://dashboard.justcrawl.io/api/v1/schedules/${scheduleId}`, {
  headers: { Authorization: `Bearer ${process.env.JUSTCRAWL_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const schedule = await res.json();

Returns the schedule including its cron expression, timezone, tag filters, next-run timestamp, and resolved workflow name (or "Automatic" when no workflowId is set). 404 if the ID belongs to another org — the response shape matches “not found” so cross-org enumeration is not possible.

Authorizations

bearerAuth

Parameters

Path Parameters

required

string

Schedule ID.

Responses

200

Schedule detail.

application/json

object

string format: uuid

name

string

workflowId

string format: uuid

nullable

tagFilters

Array<string>

frequency

string

Allowed values: hourly daily weekly monthly custom

cronExpr

string

timezone

string

isEnabled

boolean

nextRunAt

string format: date-time

lastRunAt

string format: date-time

nullable

createdAt

string format: date-time

Example

{
  "frequency": "hourly"
}

401

Missing or invalid authentication token

application/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

application/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

Schedule not found.

500

Unexpected server error. Logs and PostHog $exception capture

application/json

object

error

string

Example

{
  "error": "Something went wrong"
}