Sign in

v1

latestSwagger 2.02026-07-176738149.3 KB
participants
suggest

Returns a list of suggestions according to given parameters/filter. Search is performed within current user's indexes (messages & contacts).

get/v2/participants/suggest

Query parameters

context'msg_compose' required

current user's context (to optimize suggest relevance)

qstring required

a string (3 chars at least) from which to perform the suggestion search

Response

a list of suggestions for user to pick-up an identity

addressstring

could be empty if suggestion is a contact (or should we automatically put preferred identity's address ?)

contact_idstring

contact's ID if any

labelstring

name of contact or <display-name> in case of an address returned from participants lookup, if any

protocolstring

email, IRC…

sourcestring

'participant' or 'contact', ie from where this suggestion came from