List feature flags

Lists the project's flags in use, or the archived ones with isArchived=true, optionally only the one with a key.

Flags owned by experiments are not listed.

Errors

This operation adds no error codes of its own. It can fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Feature flags

Create a feature flag POST
Evaluate flags for an end user POST
Retrieve a feature flag GET
Update a feature flag PATCH
Archive a feature flag POST
Unarchive a feature flag POST
List a flag's variants GET
Replace a flag's variants PUT
Set who gets a flag in an environment PUT
Make test follow production DELETE
List a flag's overrides GET
Set an override PUT
Remove an override DELETE
List an end user's overrides GET

Query parameters

cursor?string

Where the page starts: the pageInfo.endCursor of the previous page. Omit it for the first page.

limit?integer

How many items to return, from 1 to 100. Defaults to 50.

Range1 <= value <= 100

key?string

Only the flag with this key; the page then holds at most one.

isArchived?string

true for only archived flags; otherwise, the default, only the ones not archived.

Value in

"true"
"false"

Examples

curl -X GET "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/feature-flags" \  -H "Authorization: Bearer vh_sk_..."

{  "data": [    {      "id": "ff_v8b3n5q0w2e7h7d2k9m4x1c6",      "projectId": "proj_tz4a98xxat96iws9zmbrgj3a",      "key": "new-checkout",      "description": "The redesigned checkout screen.",      "type": "boolean",      "environments": {        "production": {          "isEnabled": true,          "overrides": [            {              "identityType": "email",              "identityValue": "ada@example.com",              "isEnabled": true,              "variantKey": null,              "note": "QA device for the new checkout"            }          ],          "rules": [            {              "id": "beta-testers",              "name": "Beta testers",              "identities": [                {                  "identityType": "distinct_id",                  "identityValue": "user_8231"                }              ],              "serve": {                "rolloutPercentage": 100,                "variantKey": null              }            }          ],          "fallthrough": {            "rolloutPercentage": 50,            "variantKey": null          }        },        "test": null      },      "isArchived": false,      "experimentId": null,      "createdAt": "2026-02-24T10:12:45.000Z",      "updatedAt": "2026-03-09T08:30:00.000Z"    }  ],  "pageInfo": {    "endCursor": null,    "hasNextPage": false  }}

{  "error": {    "type": "invalid_request",    "code": "invalid_query",    "message": "The request query is invalid: Expected a finite number\n  at [\"limit\"]"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "permission_denied",    "message": "Insufficient permissions."  }}

{  "error": {    "type": "not_found",    "code": "project_not_found",    "message": "There is no project proj_tz4a98xxat96iws9zmbrgj3a, or this credential cannot use it.",    "param": "projectId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Errors

More in Feature flags

List feature flags

Errors

More in Feature flags

Authorization

Path parameters

Query parameters

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

List feature flags

List feature flags

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`