cURL
curl --request PATCH \
--url https://app.stockshift.io/api/v1/devices/{device} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Dock phone",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": "0199a0d0-0000-7000-8000-0000000000c1",
"offline_grace_hours": 24
}
'import requests
url = "https://app.stockshift.io/api/v1/devices/{device}"
payload = {
"name": "Dock phone",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": "0199a0d0-0000-7000-8000-0000000000c1",
"offline_grace_hours": 24
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/devices/{device}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Dock phone',
'location_id' => '0199a0d0-0000-7000-8000-0000000000b1',
'work_center_id' => '0199a0d0-0000-7000-8000-0000000000c1',
'offline_grace_hours' => 24
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.stockshift.io/api/v1/devices/{device}"
payload := strings.NewReader("{\n \"name\": \"Dock phone\",\n \"location_id\": \"0199a0d0-0000-7000-8000-0000000000b1\",\n \"work_center_id\": \"0199a0d0-0000-7000-8000-0000000000c1\",\n \"offline_grace_hours\": 24\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}{
"data": {
"id": "0199a0d0-0000-7000-8000-000000000001",
"kind": "personal",
"platform": "ios",
"name": "Dock phone",
"model": "iPhone 16",
"os_version": "19.0",
"app_version": "1.4.2",
"app_build": 311,
"key_thumbprint": "NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs",
"status": "active",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": null,
"registered_by": 7,
"offline_grace_hours": 24,
"last_seen_at": "2026-10-13T09:00:00+00:00",
"last_sync_at": "2026-10-13T09:00:00+00:00",
"wiped_at": null,
"created_at": "2026-10-12T14:32:00+00:00",
"attestation": {
"provider": "<string>",
"verdict": "<string>",
"recorded_at": "<string>"
}
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Appareils
Renommer un appareil, ou définir où il travaille
{device} est l’ID de l’appareil. Envoyez name seul pour renommer l’appareil. Le
membre à qui appartient un appareil personnel peut le renommer, et tous les autres ont besoin de
devices.manage. Envoyez l’un de location_id, work_center_id et
offline_grace_hours pour définir où l’appareil travaille et combien de temps il peut
rester hors ligne, ce qui exige devices.manage. Null efface une valeur et
l’omettre la conserve. La modification est consignée dans l’historique d’audit.
Répéter une Idempotency-Key retourne la première réponse.
Nécessite un jeton avec devices:write.
PATCH
/
devices
/
{device}
cURL
curl --request PATCH \
--url https://app.stockshift.io/api/v1/devices/{device} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Dock phone",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": "0199a0d0-0000-7000-8000-0000000000c1",
"offline_grace_hours": 24
}
'import requests
url = "https://app.stockshift.io/api/v1/devices/{device}"
payload = {
"name": "Dock phone",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": "0199a0d0-0000-7000-8000-0000000000c1",
"offline_grace_hours": 24
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/devices/{device}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Dock phone',
'location_id' => '0199a0d0-0000-7000-8000-0000000000b1',
'work_center_id' => '0199a0d0-0000-7000-8000-0000000000c1',
'offline_grace_hours' => 24
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.stockshift.io/api/v1/devices/{device}"
payload := strings.NewReader("{\n \"name\": \"Dock phone\",\n \"location_id\": \"0199a0d0-0000-7000-8000-0000000000b1\",\n \"work_center_id\": \"0199a0d0-0000-7000-8000-0000000000c1\",\n \"offline_grace_hours\": 24\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}{
"data": {
"id": "0199a0d0-0000-7000-8000-000000000001",
"kind": "personal",
"platform": "ios",
"name": "Dock phone",
"model": "iPhone 16",
"os_version": "19.0",
"app_version": "1.4.2",
"app_build": 311,
"key_thumbprint": "NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs",
"status": "active",
"location_id": "0199a0d0-0000-7000-8000-0000000000b1",
"work_center_id": null,
"registered_by": 7,
"offline_grace_hours": 24,
"last_seen_at": "2026-10-13T09:00:00+00:00",
"last_sync_at": "2026-10-13T09:00:00+00:00",
"wiped_at": null,
"created_at": "2026-10-12T14:32:00+00:00",
"attestation": {
"provider": "<string>",
"verdict": "<string>",
"recorded_at": "<string>"
}
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Autorisations
apiKeyoauth2
Pour vos propres scripts et vos intégrations de serveur à serveur. Créez une clé dans l'application sous Paramètres > Accès > Clés d'API et copiez-la à ce moment-là, car elle n'est affichée qu'une fois. Envoyez-la sous la forme Authorization: Bearer <key>. La clé agit en tant que le membre qui l'a créée, dans l'organisation où elle a été créée. Un appel exige l'autorisation du membre et l'une des portées de la clé, comme inventory:read ou sales:write. Une clé avec * a toutes les portées.
Paramètres de chemin
L'ID de l'appareil, un UUID.
Corps
application/json
Renomme un appareil, ou définit où il travaille et combien de temps il peut rester hors ligne. Une requête fait l'un ou l'autre, parce qu'ils nécessitent des autorisations différentes.
Le nouveau nom de l'appareil, 80 caractères au plus. Envoyez-le sans les autres champs.
Maximum string length:
80Exemple:
"Dock phone"
L'emplacement auquel l'appareil est affecté. Null le retire, et l'omettre le conserve.
Exemple:
"0199a0d0-0000-7000-8000-0000000000b1"
Le poste de travail auquel l'appareil est affecté. Null l'efface, et l'omettre le conserve.
Exemple:
"0199a0d0-0000-7000-8000-0000000000c1"
Combien d'heures cet appareil peut rester hors ligne avant de se verrouiller, de 8 à 720. Null suit le paramètre de l'organisation, et l'omettre conserve la valeur actuelle.
Plage requise:
8 <= x <= 720Exemple:
24
Réponse
DeviceResource
Un appareil : une installation de l'application qui contient les données de l'organisation.
Show child attributes
Show child attributes
Cette page vous a-t-elle été utile ?