Sample - Slack Web API
POST/reminders.complete

Complete a reminder

Marks a reminder as complete. Supply the reminder identifier in reminder when completing a specific reminder, and provide the authentication token when required by the authorization context. The response confirms completion.

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

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

Form-encoded reminder completion details.

reminderstringoptional
The ID of the reminder to be marked as complete

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

Error handling

The token must grant the reminders:write scope when authentication is required. reminder must identify the reminder to complete, and recurring reminders or reminders belonging to another user cannot be completed through this operation.