Skip to main content
PATCH
/
devices
/
share
/
{id}
Actualizar enlace compartido
curl --request PATCH \
  --url https://api.locatebyteli.com/devices/share/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "devices": [
    "<string>"
  ],
  "ttl": 123
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "account": "660e8400-e29b-41d4-a716-446655440000",
  "devices": ["770e8400-e29b-41d4-a716-446655440000", "990e8400-e29b-41d4-a716-446655440000"],
  "acl": ["aa0e8400-e29b-41d4-a716-446655440000"],
  "revoked": false,
  "expires_at": "2026-03-20T02:00:00Z",
  "unique_views": 5,
  "last_accessed_at": "2026-03-18T12:00:00Z",
  "created_at": "2026-03-15T00:00:00Z"
}

​
Authorization

​
Authorization
string
default:"Bearer "
required
API Key. Formato: Bearer lbt_•••

​
Path Parameters

​
id
uuid
required
ID del enlace de compartición

​
Body Parameters

​
devices
string[]
Nueva lista de UUIDs de dispositivos a compartir
​
ttl
integer
Nuevo tiempo de vida en segundos (recalcula la fecha de expiración)
Ambos campos son opcionales. Solo se actualizan los campos enviados.

​
Respuesta

Retorna el objeto UserShare actualizado.
​
id
uuid
ID del enlace de compartición
​
account
uuid
ID de la cuenta propietaria
​
devices
string[]
Lista actualizada de IDs de dispositivos compartidos
​
acl
string[]
Lista de UUIDs de permisos de acceso
​
revoked
boolean
Si el enlace fue revocado
​
expires_at
datetime
Fecha de expiración actualizada
​
unique_views
integer
Número de vistas únicas
​
last_accessed_at
datetime
Último acceso al enlace
​
created_at
datetime
Fecha de creación del enlace

​
Comportamiento

  • Si se envían devices, valida que todos existan y el usuario tenga acceso.
  • Si se envía ttl, recalcula la fecha de expiración.
  • Invalida la caché del token.
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "account": "660e8400-e29b-41d4-a716-446655440000",
  "devices": ["770e8400-e29b-41d4-a716-446655440000", "990e8400-e29b-41d4-a716-446655440000"],
  "acl": ["aa0e8400-e29b-41d4-a716-446655440000"],
  "revoked": false,
  "expires_at": "2026-03-20T02:00:00Z",
  "unique_views": 5,
  "last_accessed_at": "2026-03-18T12:00:00Z",
  "created_at": "2026-03-15T00:00:00Z"
}

​
Errores

CódigoDescripción
400Parámetros o UUID inválidos
404Enlace no encontrado
500Error interno