Sample - Slack Web API
POST/reminders.delete

Delete a reminder

Deletes a reminder. Supply the reminder identifier in reminder and provide the authentication token when required by the authorization context. The response confirms deletion.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
tokenstringoptional
Authentication token with the `reminders:write` scope.

Form-encoded reminder deletion details.

reminderstringoptional
The ID of the reminder

2 status codes
200Confirms that the reminder was deleted successfully.
okbooleanrequired
Allowed:true
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:not_foundnot_authedinvalid_authaccount_inactivetoken_revokedno_permissionorg_login_requireduser_is_botinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_data
okbooleanrequired
Allowed:false

Error handling

The token must grant the reminders:write scope when authentication is required. reminder must identify an existing reminder that the authenticated user can delete.