Sample - Slack Web API
POST/users.deletePhoto

Delete the authenticated user's profile photo

Deletes the profile photo associated with the authenticated user. Send the required authentication token in the form body to authorize removal of the current photo.

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

1 body field

Form data containing the authentication credential required to delete the authenticated user's profile photo.

tokenstringrequired
Authentication token. Requires scope: `users.profile:write`

2 status codes
200Confirms that the authenticated user's profile photo was deleted.
okbooleanrequired
Allowed:true
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:not_authedinvalid_authaccount_inactivetoken_revokedno_permissionorg_login_requireduser_is_botinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_type
okbooleanrequired
Allowed:false

Error handling

token is required and must have the users.profile:write scope. Submit the form body using the expected form-encoded format and provide a valid authentication token.