Search account profiles

Searches the account's profiles for a member picker, with free-form name/email search and an optional type filter. Account-scoped; admin only.

get/v1/account/profiles

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from previous response

querystring

Free-form search over profile name and email. Case-insensitive substring match; empty returns all profiles.

labelsstring

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

Response

Example response

{
  "items": [
    {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      }
    }
  ]
}

Changes

Changed in 5 of the 57 revisions of this API.33

Jul 8, 2026a99a473ee3ad1See the full diff
- ●
  removed the optional property pagination/total from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026e72f368ddab71See the full diff
- ○
  added the new optional query request parameter labels
  new-optional-request-parameter
Jul 2, 202606e0e37c14991See the full diff
- ○
  added the optional property items/items/metadata/createdAt to the response with the 200 status
  response-optional-property-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 5, 20260702cb021b662See the full diff
- ●
  deleted the query request parameter type
  request-parameter-removed
- ●
  added the new PROFILE_TYPE_UNSPECIFIED enum value to the items/items/spec/type response property for the response status 200
  response-property-enum-value-added
Jun 5, 2026f44878ff6c931See the full diff
- ○
  endpoint added
  endpoint-added

Full history