Skip to Content
Inbox

Scheduled messages

Cancel a scheduled message before it starts sending.

Inbox1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
X-Ken-Workspace-Idheaderinteger (int64)optionalThe id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found.

Cancel a scheduled message

POST/v1/scheduled-messages/{scheduledMessageId}/cancelscheduled-messages.cancel
Permission
Inbox edit and the reply permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Stops a queued email reply or forward before it sends. Get the id from scheduledMessageId on the reply you sent, from the forward's response, or from scheduledMessages on GET /v1/threads/{threadId}.

Only a message in scheduled or awaiting_approval status can be cancelled. Kenso saves its text back as the thread's draft and returns it in draft. Files attached to the message return to pending, so you can send them again or delete them. When the cancel succeeds but saving the draft fails, the response still returns the message with draft.saved set to false, so save the draft yourself with PUT /v1/threads/{threadId}/draft.

Errors:

  • 404 not_found: no scheduled message in this workspace has this id.
  • 409 invalid_state: the message is already sending, sent, cancelled or failed.

Requires Inbox edit and the reply permission.

Parameters

NameInTypeRequiredDescription
scheduledMessageIdpathstringrequiredThe scheduled message's numeric id.
Request
curl -X POST "https://api.ken.so/v1/scheduled-messages/812/cancel" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a ScheduledMessage.

Show the 14 response fields and an example

The fields and an example are also on this endpoint's Markdown page.


On this page