agenttools
Messages

Reschedule or edit a message

No auth required

Updates a message that hasn't fired yet (status `scheduled`). Editing a delivered, in-flight, or canceled message returns 400. Omit both `scheduled_at` and `delay_seconds` to leave the schedule unchanged.

PATCH/api/messages/{id}

Parameters

Path
idstringrequired
The scheduled message ID (`msg_…`).

Request body

urlstring
method"GET" | "POST" | "PUT" | "PATCH" | "DELETE"
headersobject | null
bodystring | null
scheduled_atinteger
delay_secondsinteger

Responses

200The updated message.
idstring
Unique identifier for the scheduled message, prefixed with `msg_`.Example: "msg_xxxxxxxxxxxxxxxxxxxxxxxx"
object"scheduled_message"
organization_idstring | null
Owning organization ID, or null if the resource is public (created without an API key).
channel"http"
Delivery channel. Only `http` is supported today.
urlstring
Target URL the request is sent to.
method"GET" | "POST" | "PUT" | "PATCH" | "DELETE"
HTTP method used for delivery.
headersobject
Request headers. Defaults to {}.
bodystring | null
Request body, if any.
scheduled_atinteger | null
When the message will fire. Unix timestamp in seconds.
status"scheduled" | "delivering" | "delivered" | "failed" | "canceled"
Delivery state.
attemptsinteger
Number of delivery attempts made.
response_statusinteger | null
HTTP status returned by the target on the last attempt.
last_errorstring | null
Error from the last attempt, if it failed.
delivered_atinteger | null
When the last delivery attempt ran. Unix timestamp in seconds.
created_atinteger | null
When the message was created. Unix timestamp in seconds.
updated_atinteger | null
When the message was last updated. Unix timestamp in seconds.
400The request was malformed or failed validation.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
401No valid API key was provided.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
403The caller is authenticated but lacks access to the resource.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
404The resource does not exist or is not visible to the caller.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.

Example request

curl
curl -X PATCH https://agtls.dev/api/messages/{id} \
  -H "Content-Type: application/json" \
  -d '{ … }'