Update a scheduled job
Changed onPartially update an existing scheduled job
Request
- Base URLhttps://api.cekura.ai
- URLhttps://api.cekura.ai/schedules/v1/cron-jobs/{id}/
- Auth
- API key in header X-CEKURA-API-KEY
- or HTTP bearer
- or HTTP bearer
Path parameters
A unique integer value identifying this cron job.
Request body
Name for the cronjob
List of scenario IDs to execute Example: [123, 456, 789]
Alternative to scenarios - List of tags to filter scenario Example: ["tag1", "tag2", "tag3"]
Agent ID. Required when using tags to filter scenarios. Example: 123
Cron expression for scheduling (e.g. '0 9 * * 1-5' for weekdays at 9am) Example:
- "0 9 * * 1-5"
- "0 0 * * 0"
Timezone for the cronjob (default: Project timezone)
- Africa/Abidjan - Africa/Abidjan
- Africa/Accra - Africa/Accra
- Africa/Addis_Ababa - Africa/Addis_Ababa
- Africa/Algiers - Africa/Algiers
- Africa/Asmara - Africa/Asmara
- Africa/Bamako - Africa/Bamako
- Africa/Bangui - Africa/Bangui
- Africa/Banjul - Africa/Banjul
- Africa/Bissau - Africa/Bissau
- Africa/Blantyre - Africa/Blantyre
- Africa/Brazzaville - Africa/Brazzaville
- Africa/Bujumbura - Africa/Bujumbura
- Africa/Cairo - Africa/Cairo
- Africa/Casablanca - Africa/Casablanca
- Africa/Ceuta - Africa/Ceuta
- Africa/Conakry - Africa/Conakry
- Africa/Dakar - Africa/Dakar
- Africa/Dar_es_Salaam - Africa/Dar_es_Salaam
- Africa/Djibouti - Africa/Djibouti
- Africa/Douala - Africa/Douala
- Africa/El_Aaiun - Africa/El_Aaiun
- Africa/Freetown - Africa/Freetown
- Africa/Gaborone - Africa/Gaborone
- Africa/Harare - Africa/Harare
- Africa/Johannesburg - Africa/Johannesburg
- Africa/Juba - Africa/Juba
- Africa/Kampala - Africa/Kampala
- Africa/Khartoum - Africa/Khartoum
- Africa/Kigali - Africa/Kigali
- Africa/Kinshasa - Africa/Kinshasa
- Africa/Lagos - Africa/Lagos
- Africa/Libreville - Africa/Libreville
- Africa/Lome - Africa/Lome
- Africa/Luanda - Africa/Luanda
- Africa/Lubumbashi - Africa/Lubumbashi
- Africa/Lusaka - Africa/Lusaka
- Africa/Malabo - Africa/Malabo
- Africa/Maputo - Africa/Maputo
- Africa/Maseru - Africa/Maseru
- Africa/Mbabane - Africa/Mbabane
- Africa/Mogadishu - Africa/Mogadishu
- Africa/Monrovia - Africa/Monrovia
- Africa/Nairobi - Africa/Nairobi
- Africa/Ndjamena - Africa/Ndjamena
- Africa/Niamey - Africa/Niamey
- Africa/Nouakchott - Africa/Nouakchott
- Africa/Ouagadougou - Africa/Ouagadougou
- Africa/Porto-Novo - Africa/Porto-Novo
- Africa/Sao_Tome - Africa/Sao_Tome
- Africa/Tripoli - Africa/Tripoli
- Africa/Tunis - Africa/Tunis
- Africa/Windhoek - Africa/Windhoek
- America/Adak - America/Adak
- America/Anchorage - America/Anchorage
- America/Chicago - America/Chicago
- America/Denver - America/Denver
- America/Los_Angeles - America/Los_Angeles
- America/New_York - America/New_York
- America/Phoenix - America/Phoenix
- America/Sao_Paulo - America/Sao_Paulo
- Asia/Dubai - Asia/Dubai
- Asia/Hong_Kong - Asia/Hong_Kong
- Asia/Kolkata - Asia/Kolkata
- Asia/Seoul - Asia/Seoul
- Asia/Shanghai - Asia/Shanghai
- Asia/Singapore - Asia/Singapore
- Asia/Tokyo - Asia/Tokyo
- Australia/Melbourne - Australia/Melbourne
- Australia/Perth - Australia/Perth
- Australia/Sydney - Australia/Sydney
- Europe/Amsterdam - Europe/Amsterdam
- Europe/Berlin - Europe/Berlin
- Europe/London - Europe/London
- Europe/Madrid - Europe/Madrid
- Europe/Moscow - Europe/Moscow
- Europe/Paris - Europe/Paris
- Europe/Rome - Europe/Rome
- Pacific/Auckland - Pacific/Auckland
- Pacific/Honolulu - Pacific/Honolulu
- US/Central - US/Central
- US/Eastern - US/Eastern
- US/Mountain - US/Mountain
- US/Pacific - US/Pacific
- UTC - UTC
DEPRECATED: Use personalities instead
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)
DEPRECATED: Use execution_mode instead. Run scenarios as text-based chat instead of voice calls
Execution mode for the cron job. Choices: voice, text, sip Example: "voice", "text", or "sip"
- 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
Response
Agent ID for the cron job Example: 123
Name for the cronjob
Crontab expression for the cron job Example:
- "0 9 * * 1-5"
- "0 0 * * 0"
Timezone for the cron job Example: "America/Los_Angeles"
List of scenario IDs for the cron job Example: [123, 456, 789]
(Deprecated) Use personalities field instead. Example: 1 (personality ID)
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)
List of tags for the cron job Example: ["tag1", "tag2", "tag3"]
Frequency for the cron job Example: 1
Max number of parallel conversations to run per execution. Leave unset for no cap (uses default capacity). Example: 3
DEPRECATED: Use execution_mode instead. Kept for backward compatibility. Run the cron job as text Example: true or false
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
Select when to notify
- never - Never
- success - Success
- failure - Failure
- both - Both
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
Timestamp when the cron job was created Example: 2021-01-01 00:00:00
Timestamp when the cron job was last updated Example: 2021-01-01 00:00:00
Changes
- info
endpoint added
- info