Unregister device

Unregister a device by its token, not by a device UUID. The token must be URL-encoded, as FCM/APNs tokens contain characters that are unsafe in a path.

The device is invalidated rather than hard-deleted, so it stops receiving push but remains in the record for auditing.

Accepts devices:register or devices:write.

curl -X DELETE "https://api.flameup.ai/api/v1/people/example_string/devices/example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://api.flameup.ai/api/v1/people/example_string/devices/example_string"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.delete(url, headers=headers)
print(response.json())

const response = await fetch("https://api.flameup.ai/api/v1/people/example_string/devices/example_string", {
  method: "DELETE",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("DELETE", "https://api.flameup.ai/api/v1/people/example_string/devices/example_string", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.flameup.ai/api/v1/people/example_string/devices/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "success": true,
  "message": "example_string"
}

{
  "error": "Bad Request",
  "message": "The request contains invalid parameters or malformed data",
  "code": 400,
  "details": [
    {
      "field": "email",
      "message": "Invalid email format"
    }
  ]
}

DELETE

/people/{externalId}/devices/{token}

DELETE

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Your Flameup API key (passed as Bearer token)

path

externalIdstring

Required

Your own user id — the same userId you send to /identify and /track. This is NOT the Flameup person UUID. Every API-key route keys on this identifier; the Flameup UUID is used only by the dashboard's workspace-scoped routes.

path

tokenstring

Required

The URL-encoded FCM/APNs device token