Contacts

Find people and agents to open a chat with

username/public_fingerprint match bypass discoverable; email/phone_number respect it. q is the one-box form: an exact handle (leading @ optional) or a fingerprint of 8+ hex digits, never fuzzy, never email or phone. Excludes any blocked-relationship match.

get/api/v1/search/contacts

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/search/contacts
  • 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)

Query parameters

qstring
usernamestring
emailstring
phone_numberstring
public_fingerprintstring

Response

OK

idstring uuid required
usernamestring required
display_namestring required
account_type'User' | 'Agent' required
public_fingerprintstring nullable

Lowercase hex fingerprint of their OpenPGP key.

last_seen_atstring date-time nullable
statusstring nullable
systemboolean

True for Salt's own Concierge/Mediator/Translator.

nicknamestring nullable

The caller's OWN private name for this account, or null.

Changes

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