---
title: "List Feature Flags"
method: GET
path: "/projects/{project_id}/workspaces/{workspace_id}/feature-flags"
tags: ["Flag Management"]
---

# List Feature Flags

`GET /projects/{project_id}/workspaces/{workspace_id}/feature-flags`

## Query parameters

- `include_archived` 'true' | 'false'

## Response `200`

Success

- union
  - ListFeatureFlagApiResponse
    - `status` string, required
    - `results` FeatureFlagApiResponse[], required
      - `can_update_basic` boolean
      - `is_superadmin` boolean
      - `allow_staff_override` boolean
      - `can_view` boolean
      - `can_share` boolean
      - `can_pin` boolean
      - `is_shared_with_project` boolean
      - `name` string, required
      - `key` string, required
      - `description` string
      - `tags` string[], required
      - `experiment_id` string, uuid4
      - `status` 'enabled' | 'disabled' | 'archived'
      - `context` string, required
      - `data_group_id` union
        - string
        - integer
      - `serving_method` 'client' | 'server' | 'remote_or_local' | 'remote_only', required
      - `ruleset` ManagementRuleSet, required
        - `variants` ManagementVariant[], required
          - `key` string, required
          - `value` union, required
            - boolean
            - string
            - unknown
          - `description` string
          - `is_control` boolean, required
          - `split` number, required
          - `is_sticky` boolean
        - `rollout` ManagementRollout[], required
          - `name` string
          - `cohort_definition` object
          - `runtime_evaluation_definition` object
          - `runtime_evaluation_rule` object
          - `runtime_event_rule` RuntimeEventRule — Configuration for first-time event targeting in rollout groups.
            - `event_name` string, required
            - `time_window` 'while_flag_enabled', required
            - `duration` 'end_of_session' | 'indefinitely'
            - `property_filters` object
          - `cohort_hash` string
          - `rollout_percentage` number, required
          - `variant_override` ManagementVariantOverride — A pointer to the variant defined under ruleset.variants[<key>]
            - `key` string, required
          - `variant_splits` object, required
        - `test` object
      - `workspace_id` integer
      - `is_experiment_active` boolean
      - `hash_salt` string
      - `reset_hash_salt` boolean
      - `id` string, uuid4, required
      - `project_id` integer, required
      - `content_type` string, required
      - `created` string, date-time, required
      - `creator_id` integer, required
      - `creator_name` string, required
      - `creator_email` string, required
      - `modified` string, date-time, required
      - `last_modified_by_id` integer
      - `last_modified_by_name` string
      - `last_modified_by_email` string
      - `is_favorited` boolean
      - `pinned_date` string
      - `enabled_at` string, date-time
      - `deleted` string, date-time
      - `content_environments_id` string
      - `project_name` string
  - ManagementApiErrorResponse
    - `status` string, required
    - `type` string, required
    - `error` union, required
      - string
      - object

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/mixpanel/apis/query-api.md) · [All operations](https://skmtc.net/mixpanel/apis/query-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpanel/query-api/versions/f442da95252a/schema)