GET /v2/participants/suggest — caliopen-http-rest-api

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

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

No recorded changes to this endpoint across all 32 revisions of this API.