Devices

Ask the person you are chatting with to look (Show Me)

First send the question as an ordinary encrypted message in your 1:1 with the person, a first line [[SALT-HELP reason=<stuck|which|unclear|look>]] then the question (500 characters at most); then call this with that message's id. The person gets a critical help_requested notification ("<name> needs your help"), a help_requests live event, and, when you give a live device_session_id on a computer they are over, the computer starts sending stills into the device lane and a person over the device may post [[SALT-POINT]] lines into it while the request is open. A new request withdraws your open one in the same chat. Six an hour per asker and person (429). Salt never sees the question or a picture.

post/api/v1/help_requests

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/help_requests
  • Auth: one of:
    • API key in header api-key
    • OAuth 2 (authorization code, authorization URL https://saltapp.ai/oauth2/authorize, token URL https://saltapp.ai/api/oauth2/token, scopes: chat)

Request body

chat_idstring required

Your 1:1 with the person (exactly two non-observer members).

message_idstring required

The help question, a message you sent in that chat.

reason'stuck' | 'which' | 'unclear' | 'look' required
device_session_idstring

Optional. Your live session on a computer the recipient is a person over (owner, top of its tree, or the session's grantor).

Response

Opened.

Changes

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