Update a device

Changes the token or the notification settings. A new token that another device entry still has moves to this one; the other entry is removed.

PATCHhttps://api.switchfile.io/v1/account/devices/{id}

Needs an API key: Authorization: Bearer YOUR_API_KEY. See Authentication.

Example

Request

curl -X PATCH "https://api.switchfile.io/v1/account/devices/b3e1f2a4-5c6d-4e7f-8a9b-0c1d2e3f4a5b" \
  -H "Authorization: Bearer $SWITCHFILE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "show_file_names": true
  }'

const res = await fetch("https://api.switchfile.io/v1/account/devices/b3e1f2a4-5c6d-4e7f-8a9b-0c1d2e3f4a5b", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SWITCHFILE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    show_file_names: true
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

<?php
$ch = curl_init('https://api.switchfile.io/v1/account/devices/b3e1f2a4-5c6d-4e7f-8a9b-0c1d2e3f4a5b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_POSTFIELDS => json_encode([
        'show_file_names' => true,
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SWITCHFILE_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException("HTTP $status: $response");
}
print_r(json_decode($response, true));

import os
import requests

res = requests.patch(
    "https://api.switchfile.io/v1/account/devices/b3e1f2a4-5c6d-4e7f-8a9b-0c1d2e3f4a5b",
    headers={"Authorization": f"Bearer {os.environ['SWITCHFILE_API_KEY']}"},
    json={
        "show_file_names": True,
    },
)
res.raise_for_status()
print(res.json())

Parameters

Path parameters

idstring (uuid)required
ID of the device

Request body

localestring
Language of the texts, for example de or en-US
matches ^[a-zA-Z]{2}([-_][a-zA-Z0-9]{2,8})?$
notify_failedboolean
notify_finishedboolean
show_file_namesboolean
start_tokenstring | null
APNs token as hex
matches ^[0-9a-fA-F]{32,200}$
tokenstring
APNs token as hex
matches ^[0-9a-fA-F]{32,200}$

Responses

200OK
created_atstringrequired
ISO 8601 timestamp
environmentstringrequired
one of "production", "sandbox"
idstring (uuid)required
live_activity_startbooleanrequired
A push-to-start token is registered
localestringrequired
notify_failedbooleanrequired
notify_finishedbooleanrequired
show_file_namesbooleanrequired
updated_atstringrequired
ISO 8601 timestamp
200 application/json
```
{
  "id": "b3e1f2a4-5c6d-4e7f-8a9b-0c1d2e3f4a5b",
  "environment": "production",
  "locale": "de",
  "notify_finished": true,
  "notify_failed": true,
  "show_file_names": true,
  "live_activity_start": false,
  "created_at": "2026-11-06T18:00:00+00:00",
  "updated_at": "2026-11-06T18:00:00+00:00"
}
```

401The API key is missing or not validUNAUTHENTICATED

401 application/problem+json

{
  "type": "https://switchfile.io/docs/api/v1#errors-unauthenticated",
  "title": "Unauthenticated",
  "status": 401,
  "code": "UNAUTHENTICATED",
  "detail": "Missing or invalid API key."
}

403Not available with a service key or a connected appNOT_AVAILABLE

403 application/problem+json

{
  "type": "https://switchfile.io/docs/api/v1#errors-not-available",
  "title": "Not available",
  "status": 403,
  "code": "NOT_AVAILABLE",
  "detail": "This endpoint is only available with your own API key or the switchfile app."
}

404Does not exist for this accountNOT_FOUND

404 application/problem+json

{
  "type": "https://switchfile.io/docs/api/v1#errors-not-found",
  "title": "Not found",
  "status": 404,
  "code": "NOT_FOUND",
  "detail": "Device not found."
}

422Invalid data. errors names the fieldsINVALID_DATA

422 application/problem+json

{
  "type": "https://switchfile.io/docs/api/v1#errors-invalid-data",
  "title": "Invalid data",
  "status": 422,
  "code": "INVALID_DATA",
  "detail": "The request contains invalid data.",
  "errors": {
    "to": [
      "Expected string"
    ]
  }
}

429Too many requests or a daily quota is used up. See Retry-AfterRATE_LIMIT_EXCEEDED

429 application/problem+json

{
  "type": "https://switchfile.io/docs/api/v1#errors-rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "RATE_LIMIT_EXCEEDED",
  "detail": "Too many requests. Try again in 12 seconds."
}

Error bodies and codes are explained in Errors.