Unlink Nintendo Switch Device Id
Unlinks the related NintendoSwitchDeviceId from the user’s PlayFab account
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| AccountNotFound | 1001 |
| AccountNotLinked | 1014 |
| InvalidNamespaceMismatch | 1561 |
| NintendoSwitchDeviceIdNotLinked | 2034 |
POST
/
Server
/
UnlinkNintendoSwitchDeviceId
Unlink Nintendo Switch Device Id
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"PlayFabId": "1234FA342",
"NintendoSwitchDeviceId": "526f79204261747479"
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId"
payload = {
"PlayFabId": "1234FA342",
"NintendoSwitchDeviceId": "526f79204261747479"
}
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({PlayFabId: '1234FA342', NintendoSwitchDeviceId: '526f79204261747479'})
};
fetch('https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'PlayFabId' => '1234FA342',
'NintendoSwitchDeviceId' => '526f79204261747479'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId"
payload := strings.NewReader("{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}Authorizations
This API requires a title secret key, available to title admins, from PlayFab Game Manager.
Body
application/json
Unique PlayFab assigned ID of the user on whom the operation will be performed.
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
Nintendo Switch Device identifier for the user. If not specified, the most recently signed in device ID will be used.
Last modified on October 1, 2026
Was this page helpful?
⌘I
Unlink Nintendo Switch Device Id
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"PlayFabId": "1234FA342",
"NintendoSwitchDeviceId": "526f79204261747479"
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId"
payload = {
"PlayFabId": "1234FA342",
"NintendoSwitchDeviceId": "526f79204261747479"
}
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({PlayFabId: '1234FA342', NintendoSwitchDeviceId: '526f79204261747479'})
};
fetch('https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'PlayFabId' => '1234FA342',
'NintendoSwitchDeviceId' => '526f79204261747479'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId"
payload := strings.NewReader("{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/UnlinkNintendoSwitchDeviceId")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"PlayFabId\": \"1234FA342\",\n \"NintendoSwitchDeviceId\": \"526f79204261747479\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}