# Reschedule bulk messaging job

Reschedule a bulk messaging job.

You cannot update a bulk messaging job which is already executing or has already executed.

# Method

PUT

# Path

/messages/bulk/[job_id]

# Path parameter

Name	Value	Required?
job_id	ID of the scheduled job	Yes

# Body parameters

Name	Value	Data type	Required?
schedule	ISO 8601 date & time (e.g., "2006-01-02T15:04:05-04:00"). If the value is in the past, messages will be sent immediately.	String	No

# Response

# HTTP status codes

Code	Remarks
200	Request was successful.
400	Validation error or request body was incorrectly formatted.
401	Authentication failed. Check `apikey` header.
404	Requested API endpoint not found.
429	The rate limit has been reached.
500-511	There was a problem processing the request on our server. Try again later.

# Response object

Name	Value	Remarks
status	`success` or `error`	-
errors	Array of object `{ msg: [error detail] }`	Only present when status is `error`.
data	Object `{ job_id: [bulk messaging job id] }`	Only present when status is `success`.

# Code sample

curl --location --request POST 'https://api.sociocs.com/messages/bulk/Xyz12345' \
--header 'apikey: your_api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "schedule: "2023-12-25T11:00:00-04:00"
}'