---
title: "GET /schedules/v1/cron-jobs/{id}/"
method: GET
path: "/schedules/v1/cron-jobs/{id}/"
tags: ["schedules"]
---

# GET /schedules/v1/cron-jobs/{id}/

`GET /schedules/v1/cron-jobs/{id}/`

Retrieve a scheduled job by id

## Path parameters

- `id` integer, required

## Response `200`

- CronJob
  - `id` integer
  - `agent` integer — Agent ID for the cron job Example: `123`
  - `name` string — Name for the cronjob
  - `crontab_expression` string, required — Crontab expression for the cron job Example: - `"0 9 * * 1-5"` - `"0 0 * * 0"`
  - `timezone` string — Timezone for the cron job Example: `"America/Los_Angeles"`
  - `scenarios` unknown
  - `scenario_ids` integer[] — List of scenario IDs for the cron job Example: `[123, 456, 789]`
  - `scenarios_data` ScenarioInline[]
    - `id` integer
    - `agent` integer, nullable
    - `name` string — Name of the scenario
    - `personality` integer, nullable
    - `personality_name` string
  - `personality` integer, nullable — (Deprecated) Use personalities field instead. Example: `1` (personality ID)
  - `personalities` integer[] — List of personalities to use for test execution. Multiple personalities can be assigned to run tests with different configurations. Example: `[1, 2, 3]` (personality IDs)
  - `tags` string[] — List of tags for the cron job Example: `["tag1", "tag2", "tag3"]`
  - `frequency` integer — Frequency for the cron job Example: `1`
  - `concurrency_limit` integer, nullable — Max number of parallel conversations to run per execution. Leave unset for no cap (uses default capacity). Example: `3`
  - `run_as_text` boolean — DEPRECATED: Use execution_mode instead. Kept for backward compatibility. Run the cron job as text Example: `true` or `false`
  - `execution_mode` 'voice' | 'text' | 'sip' | 'vapi_webrtc' | 'retell_webrtc' | 'elevenlabs' | 'ello' | 'livekit_v2' | 'pipecat_v2' | 'agora' — Execution mode for the cron job Choices: voice, text, sip, vapi_webrtc, elevenlabs, pipecat_v2, livekit_v2, retell_webrtc, ello, agora Example: `"voice"`, `"text"`, `"sip"`, `"pipecat_v2"`, `"elevenlabs"`, or `"livekit_v2"` * `voice` - Voice * `text` - Text * `sip` - SIP * `vapi_webrtc` - VAPI WebRTC * `retell_webrtc` - Retell WebRTC * `elevenlabs` - ElevenLabs * `ello` - Ello * `livekit_v2` - LiveKit * `pipecat_v2` - Pipecat * `agora` - Agora
  - `notify_on` 'never' | 'success' | 'failure' | 'both' — Select when to notify * `never` - Never * `success` - Success * `failure` - Failure * `both` - Both
  - `is_active` boolean
  - `created_by` integer
  - `created_via` 'user' | 'api' | 'mcp' | 'cli' | 'sdk' | 'null', nullable — How the cron job was created: user (UI), api (API key), or mcp (MCP client) * `user` - User * `api` - API * `mcp` - MCP * `cli` - CLI * `sdk` - SDK
  - `created_at` string, date-time — Timestamp when the cron job was created Example: `2021-01-01 00:00:00`
  - `updated_at` string, date-time — Timestamp when the cron job was last updated Example: `2021-01-01 00:00:00`

---

[API](https://skmtc.net/cekura/apis/cekura-api.md) · [All operations](https://skmtc.net/cekura/apis/cekura-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cekura/cekura-api/revisions/d08e85615b58/schema)