---
title: "Changes to Search GitHub users using natural language"
method: POST
path: "/search/users/natural-language"
---

# Changes to Search GitHub users using natural language

`POST /search/users/natural-language`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 44 revisions.

- **2026-10-16** `fa6dbe462ebc`: 18 info
- **2026-03-05** `910f8a49ca9e`: 1 info
- **2026-02-26** `0d3c77ff90a7`: 5 breaking, 5 info
- **2026-02-04** `e7ef938867e2`: 1 breaking, 2 info
- **2026-01-27** `022074fd4f45`: 5 info
- **2026-01-23** `5c9577c7441a`: 1 info

## Changes

- **2026-10-16** `fa6dbe462ebc`: 18 info
  - added the new optional request property `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/bestEmail`
  - added the new optional request property `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/revealEmails`
  - added the optional property `users/items/allOf[subschema #2]/bestEmail` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/contributes/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/contributorProfiles` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/owns/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/contributorProfiles` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/stars/edges/items/allOf[subschema #2]/contributorProfiles` to the response with the `200` status
  - added the required property `users/items/allOf[#/components/schemas/PublicUserWithDevrank]/allOf[subschema #2]/professional/experience/items/startDateConfidence` to the response with the `200` status
  - added the required property `users/items/allOf[#/components/schemas/PublicUserWithDevrank]/allOf[subschema #2]/professional/hiring` to the response with the `200` status
  - added the required property `users/items/allOf[#/components/schemas/PublicUserWithDevrank]/allOf[subschema #2]/professional/openToWork` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/contributes/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/experience/items/startDateConfidence` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/contributes/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/hiring` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/contributes/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/openToWork` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/owns/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/experience/items/startDateConfidence` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/owns/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/hiring` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/owns/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/openToWork` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/stars/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/experience/items/startDateConfidence` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/stars/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/hiring` to the response with the `200` status
  - added the required property `users/items/allOf[subschema #2]/stars/edges/items/allOf[subschema #2]/ownerProfessional/allOf[#/components/schemas/ProfessionalProfile]/openToWork` to the response with the `200` status
- **2026-03-05** `910f8a49ca9e`: 1 info
  - added the new optional request property `dataset`
- **2026-02-26** `0d3c77ff90a7`: 5 breaking, 5 info
  - removed `subschema #1, subschema #2, subschema #3` from the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/contributes/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/followers/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/following/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/owns/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/stars/filters` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/contributes/filters` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/followers/filters` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/following/filters` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/owns/filters` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/stars/filters` request property `anyOf` list
- **2026-02-04** `e7ef938867e2`: 1 breaking, 2 info
  - the response property `users/items/allOf[subschema #2]/` became nullable for the status `200`
  - added the new optional request property `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/aggregates`
  - added the optional property `users/items/allOf[#/components/schemas/PublicUserWithDevrank]/allOf[subschema #2]/aggregates` to the response with the `200` status
- **2026-01-27** `022074fd4f45`: 5 info
  - added the new optional request property `includeAttributes/allOf[#/components/schemas/UserIncludeAttributes]/professional`
  - added the optional property `users/items/allOf[#/components/schemas/PublicUserWithDevrank]/allOf[subschema #2]/professional` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/contributes/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/owns/allOf[#/components/schemas/PaginatedRepositories]/edges/items/allOf[subschema #2]/ownerProfessional` to the response with the `200` status
  - added the optional property `users/items/allOf[subschema #2]/stars/edges/items/allOf[subschema #2]/ownerProfessional` to the response with the `200` status
- **2026-01-23** `5c9577c7441a`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/bountylaboratories/apis/bounty-lab-public-api/docs/search/users/natural-language/post.md) - [API](https://skmtc.dev/bountylaboratories/apis/bounty-lab-public-api.md) - [Page](https://skmtc.dev/bountylaboratories/apis/bounty-lab-public-api/changes/search/users/natural-language/post)