PIpixiebrix
support

GET /api/support/flags/

Changed on

List waffle flags with their activation state and targeting breadth.

Written for flag-retirement audits: everyone plus everyone_since identify flags that have been GA long enough to retire, and the targeting counts identify who would lose access if one were deleted. Counts rather than rosters, so the response carries no customer PII.

Request

  • Base URL
    https://app.pixiebrix.com
  • Auth
    none declared

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

everyonestring

Optional. true for flags forced on for everyone, false for flags forced off. Omit to include flags with no override, which neither value matches.

qstring

A search term.

Response

idinteger
namestring

The human/computer readable name.

notestring

Note where this Flag is used.

everyoneboolean nullable

Flip this flag on (Yes) or off (No) for everyone, overriding all other settings. Leave as Unknown to use normally.

everyone_sincestring date-time nullable

ISO-8601 timestamp of the Django Admin action that everyone_since_source names, or null when no such action could be established. Read the two fields together.

everyone_since_source'admin_change' | 'admin_addition' | 'no_admin_entry' | 'external_write' nullable

Provenance of everyone_since, and how far to trust it. "admin_change" carries the date of the admin edit that set the field; "admin_addition" carries a creation date instead, because creation logs no field values. Neither is proof, and both can only err early: a write outside the admin is invisible when it skips Flag.save() (QuerySet.update(), raw SQL) or when a later admin edit hides it, so read the date as the earliest the flag could have gone GA. "no_admin_entry" and "external_write" carry no date and mean unknown. Null when the flag is not on for everyone and the question does not apply.

superusersboolean

Flag always active for superusers?

staffboolean

Flag always active for staff?

authenticatedboolean

Flag always active for authenticated users?

createdstring date-time

Date when this Flag was created.

modifiedstring date-time

Date when this Flag was last modified.

users_countinteger
organizations_countinteger
groups_countinteger
organization_groups_countinteger
django_admin_urlstring

Path to the flag in Django Admin, where a human deletes it.

Changes