---
title: "List scheduled jobs"
method: GET
path: "/schedules/v1/cron-jobs/"
tags: ["schedules"]
---

# List scheduled jobs

`GET /schedules/v1/cron-jobs/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/schedules/v1/cron-jobs/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer

List all scheduled jobs

## Query parameters

- `agent_id` string
- `project_id` string
- `organization_id` integer

## 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_settings` unknown
  - `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, nullable
  - `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`

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/schedules/v1/cron-jobs/get.md)

---

[API](https://skmtc.dev/cekura/apis/cekura-api.md) - [All operations](https://skmtc.dev/cekura/apis/cekura-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cekura/apis/cekura-api/revisions/a6fb6a739212?raw)