> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rivi.software/llms.txt
> Use this file to discover all available pages before exploring further.

# Unregister a push device

> Remove the supplied token from this station. Requires the public station gate or a station credential carrying push:register.



## OpenAPI

````yaml /radiotools/openapi.json delete /api/v1/stations/{stationSlug}/push/devices
openapi: 3.1.0
info:
  title: RadioTools API
  version: 1.0.0
  description: >-
    RadioTools APIs for listener websites and apps, published media, and
    now-playing metadata ingestion.
servers:
  - url: https://radiotools.rivi.software
    description: radiotools API
security: []
tags:
  - name: Public listener
    description: >-
      Tenant-token published delivery (listener:read; push:register for device
      changes). Published media remains anonymous. OPTIONS allows every origin;
      JSON is no-store with a strong ETag for conditional polling.
  - name: Ingest
    description: >-
      Automation credentials. The credential resolves the station; payloads
      cannot change it.
paths:
  /api/v1/stations/{stationSlug}/push/devices:
    delete:
      tags:
        - Public listener
      summary: Unregister a listener push device
      description: >-
        Remove the supplied token from this station. Requires the public station
        gate or a station credential carrying push:register.
      parameters:
        - schema:
            type: string
            minLength: 3
            maxLength: 63
          required: true
          name: stationSlug
          in: path
          description: >-
            Public station slug from the station settings; distinct from the
            internal station ID.
          example: radio-rivier
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                token:
                  type: string
                  minLength: 1
                  maxLength: 4096
                  description: >-
                    Push provider device token. This is not an API credential;
                    never use a real device token in shared examples.
                  example: fictional-fcm-device-token
              required:
                - token
              example:
                token: fictional-fcm-device-token
            examples:
              device:
                summary: Remove a registered device
                description: >-
                  Illustrative response using fictional station data. Replace
                  identifiers with values returned by your station.
                value:
                  token: fictional-fcm-device-token
      responses:
        '200':
          description: >-
            Token removed if it was registered This imported contract does not
            specify a response body; treat the HTTP status as the documented
            result.
        '400':
          description: Invalid unregister body
        '401':
          description: Station credential missing or invalid
        '404':
          description: Station unavailable
      security:
        - machineToken: []
components:
  securitySchemes:
    machineToken:
      type: http
      scheme: bearer
      bearerFormat: rtm_…
      description: >-
        Station-scoped listener credential. Send Authorization: Bearer
        `<token>`, for example Bearer rtm_…. Sending the rtm_ token alone
        without Bearer returns 401 UNAUTHENTICATED. In the interactive
        playground, enter only the raw rtm_ token; the playground adds the
        prefix. Listener REST and GraphQL: listener:read. Listener devices:
        push:register.

````

## Related topics

- [Register a push device](/radiotools/api-reference/public-listener/register-push-device.md)
- [Public delivery](/radiotools/api-reference/public-delivery.md)
- [Update push topics](/radiotools/api-reference/public-listener/update-push-topics.md)
- [Integrations](/radiotools/station-admin/integrations.md)
- [Listener alerts](/radiotools/daily-work/listener-alerts.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.