> ## Documentation Index > Fetch the complete documentation index at: https://docs.talkifai.dev/llms.txt > Use this file to discover all available pages before exploring further. # Reschedule Batch Job > Reschedule a scheduled or pending batch job to a new start time. ## Overview Changes the scheduled start time of a batch job. Only works for jobs in `scheduled` or `pending` status. **Features:** * Timezone-aware scheduling * Automatic cancellation of old scheduled job * Creates new Redis defer job with updated time Cannot reschedule jobs that are already `running`, `completed`, `failed`, or `cancelled`. ## Request ```bash theme={null} PATCH /batch/jobs/{batch_job_id}/reschedule?scheduledStartTime=2025-03-01T10:00:00&timezone=America/New_York ``` ## Path Parameters | Parameter | Type | Required | Description | | -------------- | ------ | -------- | --------------------------- | | `batch_job_id` | string | ✅ | Unique batch job identifier | ## Query Parameters | Parameter | Type | Required | Default | Description | | -------------------- | ------ | -------- | ------- | ------------------------------------------ | | `scheduledStartTime` | string | ✅ | — | New scheduled start time (ISO 8601 format) | | `timezone` | string | ❌ | `"UTC"` | IANA timezone for the scheduled time | ### Timezone Examples | Timezone | Description | | --------------------- | -------------------------- | | `UTC` | Coordinated Universal Time | | `America/New_York` | Eastern Time (US/Canada) | | `America/Los_Angeles` | Pacific Time (US/Canada) | | `Europe/London` | GMT/BST (UK) | | `Europe/Paris` | Central European Time | | `Asia/Karachi` | Pakistan Standard Time | | `Asia/Dubai` | Gulf Standard Time | | `Asia/Tokyo` | Japan Standard Time | | `Australia/Sydney` | Australian Eastern Time | ## Response ```json theme={null} { "success": true, "message": "Rescheduled successfully (old job cancelled)", "batchJobId": "batch_xyz789", "scheduledStartTime": "2025-03-01T15:00:00Z", "status": "scheduled", "oldJobCancelled": true, "newScheduledJobId": "arq_job_abc123" } ``` ### Response Fields | Field | Type | Description | | -------------------- | ------- | ---------------------------------------- | | `success` | boolean | Whether reschedule succeeded | | `message` | string | Reschedule result description | | `batchJobId` | string | Rescheduled batch job ID | | `scheduledStartTime` | string | New scheduled start time (ISO 8601, UTC) | | `status` | string | Job status (`scheduled`) | | `oldJobCancelled` | boolean | Whether old Redis job was cancelled | | `newScheduledJobId` | string | New Redis defer job ID | ## Examples ### Example 1: Reschedule to Later Time ```bash theme={null} curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_xyz789/reschedule?scheduledStartTime=2025-03-01T10:00:00&timezone=America/New_York" \ -H "Authorization: Bearer YOUR_API_KEY" ``` **Response:** ```json theme={null} { "success": true, "message": "Rescheduled successfully (old job cancelled)", "batchJobId": "batch_xyz789", "scheduledStartTime": "2025-03-01T15:00:00Z", "status": "scheduled", "oldJobCancelled": true, "newScheduledJobId": "arq_job_abc123" } ``` ### Example 2: Reschedule with UTC Timezone ```bash theme={null} curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_xyz789/reschedule?scheduledStartTime=2025-03-01T09:00:00&timezone=UTC" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Example 3: Reschedule Pending Job (No Previous Schedule) ```bash theme={null} curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_pending/reschedule?scheduledStartTime=2025-03-01T09:00:00&timezone=Europe/London" \ -H "Authorization: Bearer YOUR_API_KEY" ``` **Response:** ```json theme={null} { "success": true, "message": "Scheduled successfully", "batchJobId": "batch_pending", "scheduledStartTime": "2025-03-01T09:00:00Z", "status": "scheduled", "oldJobCancelled": false, "newScheduledJobId": "arq_job_def456" } ``` ### Example 4: Reschedule Running Job (Error) ```bash theme={null} curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_running/reschedule?scheduledStartTime=2025-03-01T09:00:00&timezone=UTC" \ -H "Authorization: Bearer YOUR_API_KEY" ``` **Response:** ```json theme={null} { "detail": "Cannot reschedule job in 'running' status. Only 'scheduled' or 'pending' jobs can be rescheduled." } ``` ## Behavior by Status | Job Status | Reschedule Behavior | | ----------- | ------------------------------------------------------------------------ | | `scheduled` | Cancels old Redis job + creates new defer job + updates DB | | `pending` | Creates new Redis defer job + updates DB + changes status to `scheduled` | | `running` | ❌ Error: Cannot reschedule running job | | `completed` | ❌ Error: Cannot reschedule completed job | | `failed` | ❌ Error: Cannot reschedule failed job | | `cancelled` | ❌ Error: Cannot reschedule cancelled job | ## How It Works ``` PATCH /batch/jobs/{id}/reschedule │ ▼ 1. Parse scheduled time + timezone ├── Invalid format → 400 Error └── Valid → Convert to UTC │ ▼ 2. Check job status ├── Not scheduled/pending → 400 Error └── Scheduled/Pending → Continue │ ▼ 3. If has scheduledJobId: Cancel old Redis job ├── Found → Cancel + clear └── Not found → Proceed │ ▼ 4. Create new Redis defer job │ ▼ 5. Update database with new time + job ID │ ▼ 6. Return success ``` ## Error Handling ### 404 Not Found ```json theme={null} { "detail": "Batch job not found" } ``` ### 400 Bad Request ```json theme={null} { "detail": "Invalid timezone 'Invalid/Timezone'. Use IANA timezone format (e.g., 'America/New_York', 'Asia/Karachi', 'UTC')." } ``` ```json theme={null} { "detail": "Invalid datetime format. Use format like '2025-03-01T10:00:00'." } ``` ```json theme={null} { "detail": "Cannot reschedule job in 'running' status. Only 'scheduled' or 'pending' jobs can be rescheduled." } ``` | Error Code | Cause | | --------------------- | --------------------------------------------- | | `job_not_found` | Batch job ID doesn't exist | | `invalid_timezone` | Invalid IANA timezone | | `invalid_datetime` | Invalid datetime format | | `past_scheduled_time` | Scheduled time is in the past | | `invalid_status` | Job is not in `scheduled` or `pending` status | ### 500 Internal Server Error ```json theme={null} { "detail": "Failed to reschedule batch job" } ``` ## Use Cases ### Reschedule Due to Weather Event Your campaign is scheduled for today, but a storm is affecting your target region: ```bash theme={null} # Reschedule from today to tomorrow same time curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_xyz789/reschedule?scheduledStartTime=2025-03-02T09:00:00&timezone=America/New_York" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Adjust Calling Hours for Compliance You realize your scheduled time violates calling hours regulations: ```bash theme={null} # Reschedule from 7 AM to 9 AM (legal calling hours start) curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_xyz789/reschedule?scheduledStartTime=2025-03-01T09:00:00&timezone=America/Chicago" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Postpone Campaign to Next Week ```bash theme={null} # Move campaign from Friday to next Monday curl -X PATCH "https://api.talkifai.com/batch/jobs/batch_xyz789/reschedule?scheduledStartTime=2025-03-10T10:00:00&timezone=America/Los_Angeles" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Related * [Create Batch Job](/api-reference/endpoint/create-batch-job) — Create a new batch job * [Start Batch Job](/api-reference/endpoint/start-batch-job) — Start scheduled job immediately * [Cancel Batch Job](/api-reference/endpoint/cancel-batch-job) — Cancel a job * [Get Batch Job Detail](/api-reference/endpoint/get-batch-job) — Get job status * [Batch Calling Guide](/platform/batch-calling) — Complete guide to batch campaigns ## OpenAPI ````yaml PATCH /batch/jobs/{batch_job_id}/reschedule openapi: 3.1.0 info: title: TalkifAI API version: 1.0.0 description: Build and manage AI voice and chat agents programmatically. servers: - url: https://api.talkifai.dev description: Production security: - bearerAuth: [] tags: - name: Agents description: Create and manage voice and chat agents - name: Voice Calls description: Initiate outbound calls and retrieve call data - name: Text Chat description: Text chat sessions via REST + SSE - name: Batch Calling description: Run large-scale outbound call campaigns paths: /batch/jobs/{batch_job_id}/reschedule: patch: tags: - Batch Calling summary: Reschedule Batch Job description: Reschedule a scheduled or pending batch job to a new start time. operationId: rescheduleBatchJob parameters: - name: batch_job_id in: path required: true schema: type: string - name: scheduledStartTime in: query required: true schema: type: string format: date-time description: New scheduled start time (ISO 8601) - name: timezone in: query required: false schema: type: string default: UTC description: IANA timezone for the scheduled time responses: '200': description: Batch job rescheduled content: application/json: schema: type: object properties: success: type: boolean example: true message: type: string example: Rescheduled successfully batchJobId: type: string scheduledStartTime: type: string format: date-time status: type: string example: scheduled oldJobCancelled: type: boolean newScheduledJobId: type: string '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_status: value: detail: Cannot reschedule job in 'running' status invalid_timezone: value: detail: Invalid timezone 'Invalid/Zone' past_time: value: detail: Scheduled time must be in the future '401': $ref: '#/components/responses/Unauthorized' '404': description: Batch job not found content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: Error: type: object properties: success: type: boolean example: false error: type: string example: Error message code: type: string example: ERROR_CODE responses: Unauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Invalid API key code: invalid_api_key securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: tk_live_... description: Your TalkifAI API key. Get it from Studio → Settings → API Keys. ````