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>"
]
}
]
}Dispositivos
Cambia el nombre de un dispositivo, o define dónde trabaja
{device} es el ID del dispositivo. Envía solo name para cambiar el nombre del dispositivo. El
miembro al que pertenece un dispositivo personal puede cambiarle el nombre, y todos los demás necesitan
devices.manage. Envía cualquiera de location_id, work_center_id y
offline_grace_hours para establecer dónde trabaja el dispositivo y cuánto tiempo puede
estar sin conexión, lo que requiere devices.manage. Null borra un valor y
omitirlo lo conserva. El cambio queda registrado en el historial de auditoría.
Repetir una Idempotency-Key devuelve la primera respuesta.
Requiere un token con 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>"
]
}
]
}Autorizaciones
apiKeyoauth2
Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.
Parámetros de ruta
El ID del dispositivo, un UUID.
Cuerpo
application/json
Cambia el nombre de un dispositivo, o define dónde trabaja y cuánto tiempo puede estar sin conexión. Una solicitud hace una de las dos cosas, porque requieren permisos distintos.
El nuevo nombre del dispositivo, de hasta 80 caracteres. Envíalo sin los demás campos.
Maximum string length:
80Ejemplo:
"Dock phone"
La ubicación a la que está asignado el dispositivo. Con null se quita, y si se omite se conserva.
Ejemplo:
"0199a0d0-0000-7000-8000-0000000000b1"
El centro de trabajo al que está asignado el dispositivo. Con null se quita, y si no se envía se conserva.
Ejemplo:
"0199a0d0-0000-7000-8000-0000000000c1"
Cuántas horas puede este dispositivo estar sin conexión antes de bloquearse solo, de 8 a 720. Null sigue la configuración de la organización, y si se omite se conserva.
Rango requerido:
8 <= x <= 720Ejemplo:
24
Respuesta
DeviceResource
Un dispositivo: una instalación de la app que guarda los datos de la organización.
Show child attributes
Show child attributes
¿Esta página le ayudó?