# Reschedule bulk messaging job

Reschedule a bulk messaging job.

# 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"
}'