Device Management

Create Device

POST /api/v1/device

Register a new device for anonymous user tracking. Idempotent - calling with same device_id returns existing device.

Returns device_instance_id that frontend should store permanently.

post/api/v1/device

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/device
  • Auth: none declared

Request body

device_idstring required
device_infoobject nullable

Example request

{
  "device_id": "550e8400-e29b-41d4-a716-446655440000",
  "device_info": {
    "app_version": "1.2.0",
    "device_model": "Pixel 7 Pro",
    "device_type": "android",
    "os_version": "14.0"
  }
}

Response

Successful Response

idinteger required
scan_limitinteger required
scans_remaininginteger required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.