Skip to content

Document status filter on GET /v1/users#53

Merged
tejanium merged 1 commit into
mainfrom
LA-36813/document-users-status-filter
Jun 9, 2026
Merged

Document status filter on GET /v1/users#53
tejanium merged 1 commit into
mainfrom
LA-36813/document-users-status-filter

Conversation

@tejanium

@tejanium tejanium commented Jun 9, 2026

Copy link
Copy Markdown

Jira

LA-36813

What

Documents the new filters[status] query param on GET /v1/users, shipped by code PR learnamp/learnamp#23668 (merged). The endpoint reference was missing it.

Adds one row to the "Optional Filters in URL Params" table:

  • Accepts an array of statuses, or a comma-separated string (same shape as filters[team_ids]).
  • Matches users in any of the given statuses.
  • Allow-list (verified against APIServices::Filters::Users::VALID_STATUSES and the Grape param): not_invited, invite_scheduled, invite_pending, confirmed, deactivated.

Why

Docs-accuracy: the live endpoint accepts the filter, but the reference didn't list it.


Note

Low Risk
Documentation-only change in _users.md; no runtime or API behavior is modified.

Overview
Documents filters[status] on GET /v1/users, aligning the reference with behavior already shipped in the API.

The new table row describes filtering users who match any of the supplied statuses, using either an array or comma-separated values (same pattern as filters[team_ids]). Allowed values are not_invited, invite_scheduled, invite_pending, confirmed, and deactivated.

Reviewed by Cursor Bugbot for commit 798d673. Bugbot is set up for automated code reviews on this repo. Configure here.

@tejanium tejanium marked this pull request as ready for review June 9, 2026 08:16
@tejanium tejanium merged commit b076d0e into main Jun 9, 2026
2 checks passed
@tejanium tejanium deleted the LA-36813/document-users-status-filter branch June 9, 2026 10:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant