Skip to content
forgit api docs

List all feature flags for a project

GET
/api/v4/projects/{id}/feature_flags

Lists all feature flags of the requested project. Use the page and per_page pagination parameters to control the pagination of results.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
One of:
string

The ID or URL-encoded path of the project

Query Parameters

Section titled “Query Parameters”
scope
string
nullable
Allowed values: enabled disabled

The scope of feature flags, one of: enabled, disabled

page
integer
default: 1 nullable

Current page number

Example
1
per_page
integer
default: 20 nullable

Number of items per page

Example
20

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
name
string
description
string
active
boolean
version
string
created_at
string format: date-time
updated_at
string format: date-time
scopes
array
strategies
object
id
integer format: int64
name
string
parameters
string
scopes
object
id
integer format: int64
environment_scope
string
user_list
object
id
integer format: int64
iid
integer
name
string
user_xids
string
Example
{
  "name": "merge_train",
  "description": "merge train feature flag",
  "version": "new_version_flag",
  "created_at": "2019-11-04T08:13:51.423Z",
  "updated_at": "2019-11-04T08:13:51.423Z",
  "strategies": {
    "id": 1,
    "name": "userWithId",
    "parameters": "{\"userIds\": \"user1\"}",
    "scopes": {
      "id": 1,
      "environment_scope": "production"
    },
    "user_list": {
      "id": 1,
      "iid": 1,
      "name": "user_list",
      "user_xids": "user1,user2"
    }
  }
}

400

Section titled “400”

Bad Request

401

Section titled “401”

Unauthorized

404

Section titled “404”

Not found