GET /api/users/suggest

suggest users in your community for autocompletion

Success Response Code: 200

Params

Param name Description
q
required

search term


Value: Must be a String
admins
optional

only include admins (default=false)


Value: Must be one of: <code>true</code>, <code>false</code>.
include_external_contributors
optional

include external contributors in the suggestion results


Value: Must be one of: <code>true</code>, <code>false</code>.

Response Fields

users see #show for details Array<User>

Example Curl Commands

curl -X GET -v --basic -u "emily@socialcast.com:demo" "https://demo.socialcast.com/api/users/suggest.json?q=Jenni"

Examples

GET /api/users/suggest.json
200
{
  "users": [
    {
      "contact_info": {
        "email": "active'47@socialcast.com"
      },
      "manager": null,
      "custom_fields": [],
      "followable": false,
      "contact_id": null,
      "following_count": 0,
      "followers_count": 0,
      "status_message": null,
      "id": 51,
      "first_name": "Abcdjoe",
      "last_name": "Zebulon",
      "name": "Abcdjoe Zebulon",
      "html_name": "Abcdjoe Zebulon",
      "url": "https://socialcast.socialcast.test/users/51-abcdjoezebulon",
      "avatars": {
        "is_system_default": false,
        "id": 4,
        "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=a8e301d7904b920054723ef38465a55c7a8ed09ad56d4d4f650afc83e8fec2d1",
        "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=dae6a428c276e94766825769d9f9ca9a1bbc4d14d4ec547b9dd128257d2f2e7a",
        "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=080a19ec88827215ee82eefe0ae5c22e36f9a11d81cea751863eb3b8a42badc9",
        "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=c5ac48aae01b9a5bb47a6b49712a5e8e9d30e3469757044419e702a8be9bf9aa",
        "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=81981e90c49974a04f9034c8b1fd0829f9c571874c8efe874ec90c48518f9773",
        "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180115T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=b076b153c9dc07fb39037f411cad8a5b3569c5c635c6c71eec254f859f4ea535"
      },
      "username": "AbcdjoeZebulon",
      "active": true,
      "terminated": false,
      "inactive": false,
      "role": "tenant_admin",
      "type": "User",
      "title": null,
      "out_of_office": false,
      "out_of_office_on": null,
      "back_in_office_on": null,
      "company_login": null
    }
  ]
}