Stop push to this device

DELETE/api/v1/mailbox/devices/current
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Unregisters the device this session belongs to. Call it on sign-out in your app.

Errors

Status When
401 No token, or the session expired or was signed out. Sign in again with POST /mailbox-auth/login.
403 The account has a temporary password: until POST /security/password succeeds, every other call answers this with error_code: password_change_required.

Request

DELETE/api/v1/mailbox/devices/current
curl -X DELETE 'https://courier.mailyte.com/api/v1/mailbox/devices/current' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

Response

Successful Response

  • dataobject
    • idstring
    • platformstring
    • app_versionstring or null
    • created_atstring or null
    • last_seen_atstring or null
    • push_enabledboolean
200application/json
{
  "type": "success",
  "msg": "Device unregistered",
  "data": {
    "id": "",
    "platform": "",
    "app_version": null,
    "created_at": null,
    "last_seen_at": null,
    "push_enabled": false
  }
}

Returned inside the standard envelope.

Errors

StatusWhen
401No token, or the session expired or was signed out. Sign in again with `POST /mailbox-auth/login`.
403The account has a temporary password: until `POST /security/password` succeeds, every other call answers this with `error_code: password_change_required`.
500Database unavailable

Every status, with what causes it and what to do, is on the error reference.