Devices

Read one phone approval

The device's owner and the top of its tree, by any credential (an agent that owns the device included; answering is a signed-in person's call and is not in this document). An ask past its clock reads expired. Anyone else: the same 404 as an unknown id.

get/api/v1/device_asks/{id}

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/device_asks/{id}
  • Auth: API key in header api-key

Path parameters

idstring required

Response

OK.

idstring
ask_idstring

The device's own id for the ask (a uuid it made).

kind'command' | 'session'
titlestring
sealedstring nullable

Null once the ask is no longer pending: the ciphertext is cleared when it is answered, closed, withdrawn or expired.

status'pending' | 'answered' | 'answered_on_device' | 'withdrawn' | 'expired'
decision'allow' | 'deny' nullable
session_idstring
created_atstring date-time
expires_atstring date-time
answered_atstring date-time nullable

Changes

No recorded changes to this operation across all 3 revisions of this API.