The Members Autocomplete API provides fast, as-you-type member suggestions for a company.

This endpoint is linked from Membership company resources via rel="memberautocomplete", but the endpoint URL is on the members API path.

Returns members that match the beginning of first name, last name, or email.

Results are constrained to the requested companyId, and the caller must be a member of that company.

When the caller is an external member, the endpoint returns 200 OK with an empty members array.

GET /members/companies/123/autocomplete?q=isi&hits=10 HTTP/1.1
Accept: application/vnd.huddle.data+xml (or+json)
Authorization: Bearer frootymcnooty/vonbootycherooty

HTTP/1.1 200 OK
Content-Type: application/vnd.huddle.data+xml

<membersAutocomplete>
    <link rel="self" href="/members/companies/123/autocomplete?q=isi&hits=10" />
    <members>
        <actor rel="member" name="Isidore McHohenheim" email="[email protected]">
            <link rel="avatar" href="/members/users/456/avatar?h=..." type="image/jpg" />
            <link rel="profile" href="https://my.huddle.example/user/456" />
            <identity email="[email protected]" />
        </actor>
    </members>
</membersAutocomplete>

HTTP/1.1 200 OK
Content-Type: application/vnd.huddle.data+json

{
  "links": [
    { "rel": "self", "href": "/members/companies/123/autocomplete?q=isi&hits=10" }
  ],
  "members": [{
    "links": [
        { "rel": "avatar", "href" : "/members/users/456/avatar?h=...", "type" : "image/jpg" },
        { "rel": "profile", "href": "https://my.huddle.example/user/456" }
    ],
    "name": "Isidore McHohenheim",
    "email": "[email protected]",
    "rel": "member",
    "identity": {
        "email": "[email protected]"
    }
  }]
}

Note: member entries include avatar and profile links, and do not include self or alternate links.