Devices

Set a Lusor Phone's identity

Sets the device identity apps read: brand, manufacturer, model, device codename, product name, build fingerprint and Android ID. Only the fields sent change. Raw Android properties are refused (400 identity_prop_refused). Answers 202 with the change pending; once written (state applied, restartQueued true) the phone restarts to apply it, which takes a few minutes. The values persist across restarts and resets; set the old values again to undo a change.

PUT

workspaces

{workspaceId}

devices

{deviceId}

identity

Set a Lusor Phone's identity

curl --request PUT \
  --url https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "brand": "google",
  "manufacturer": "Google",
  "model": "Pixel 8",
  "device": "shiba",
  "name": "shiba",
  "fingerprint": "<string>",
  "androidId": "<string>"
}
'

const options = {
  method: 'PUT',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    brand: 'google',
    manufacturer: 'Google',
    model: 'Pixel 8',
    device: 'shiba',
    name: 'shiba',
    fingerprint: '<string>',
    androidId: '<string>'
  })
};

fetch('https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity"

payload = {
    "brand": "google",
    "manufacturer": "Google",
    "model": "Pixel 8",
    "device": "shiba",
    "name": "shiba",
    "fingerprint": "<string>",
    "androidId": "<string>"
}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "fields": {
      "brand": "google",
      "manufacturer": "Google",
      "model": "Pixel 8",
      "device": "shiba",
      "name": "shiba",
      "fingerprint": "<string>",
      "androidId": "<string>"
    },
    "state": "pending",
    "restartQueued": true,
    "error": "phone_not_ready",
    "inProgress": "language"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

X-Api-Key

string

header

required

Workspace API key, created in the dashboard under Settings → API Keys.

Path Parameters

workspaceId

string<uuid>

required

Workspace UUID. Caller must have access.

deviceId

string

required

Device id (paired into the workspace).

Body

application/json

At least one field. Text fields are 1-64 letters, digits, spaces or . _ + -.

brand

string

Example:

"google"

manufacturer

string

Example:

"Google"

model

string

Example:

"Pixel 8"

device

string

Device codename (ro.product.device).

Example:

"shiba"

name

string

Product name (ro.product.name).

Example:

"shiba"

fingerprint

string

Build fingerprint: brand/name/device:release/id/incremental:type/tags.

Maximum string length: 200

androidId

string

The Android ID, 16 hex digits.

Pattern: ^[0-9A-Fa-f]{16}$

Response

The change was accepted

data

object

required

Show child attributes

Set a Lusor Phone's identity

curl --request PUT \
  --url https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "brand": "google",
  "manufacturer": "Google",
  "model": "Pixel 8",
  "device": "shiba",
  "name": "shiba",
  "fingerprint": "<string>",
  "androidId": "<string>"
}
'

const options = {
  method: 'PUT',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    brand: 'google',
    manufacturer: 'Google',
    model: 'Pixel 8',
    device: 'shiba',
    name: 'shiba',
    fingerprint: '<string>',
    androidId: '<string>'
  })
};

fetch('https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.lusor.ai/v1/workspaces/{workspaceId}/devices/{deviceId}/identity"

payload = {
    "brand": "google",
    "manufacturer": "Google",
    "model": "Pixel 8",
    "device": "shiba",
    "name": "shiba",
    "fingerprint": "<string>",
    "androidId": "<string>"
}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "fields": {
      "brand": "google",
      "manufacturer": "Google",
      "model": "Pixel 8",
      "device": "shiba",
      "name": "shiba",
      "fingerprint": "<string>",
      "androidId": "<string>"
    },
    "state": "pending",
    "restartQueued": true,
    "error": "phone_not_ready",
    "inProgress": "language"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Overview

Endpoints

Set a Lusor Phone's identity

Authorizations

Path Parameters

Body

Response