feature-flags

List flags

Changed on

Retrieve feature flags for a project. The list can be filtered by state and supports pagination.

get/v1/projects/{projectIdOrName}/feature-flags/flags

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v1/projects/{projectIdOrName}/feature-flags/flags
  • Auth: HTTP bearer

Path parameters

projectIdOrNamestring required

The project id or name

Query parameters

state'active' | 'archived'

The state of the flags to retrieve. Defaults to active.

withMetadataboolean

Deprecated. Whether to include creator metadata in each flag in the response. Resolve creator identity client-side (e.g. via the team members endpoint) instead; this parameter will be removed in a future release. Use GET /v1/projects/:id/feature-flags/flags/:flagIdOrSlug?withMetadata=true for single-flag lookups that need creator metadata.

limitinteger

Maximum number of flags to return. When not set, all flags are returned.

cursorstring

Pagination cursor to continue from.

searchstring

Search flags by their slug or description. Case-insensitive.

tagsstring[]

Filter flags by tag. Repeat the parameter for multiple tags (all must match).

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

Changes

  • 8939e3983223Revision changes
    • info

      added the optional property // to the response with the status

  • 099fbe1f521cRevision changes
    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property //////// to the response with the status