RUrunway
release

List a release's feature flags

Returns all feature flags for a release, sourced from the app's connected feature flagging integration (LaunchDarkly, Statsig, or Optimizely). Each flag includes its id, name, current status (enabled/disabled/archived/paused), type, rollout percentage, targeting rules and variations, and whether it is read-only. Use a flag's id with the toggle endpoint to enable or disable it. Returns an empty array when the app has no feature flagging integration installed.

get/app/{appId}/release/{releaseId}/featureFlags

Request

  • Base URL
    https://api.runway.team
  • URL
    https://api.runway.team/app/{appId}/release/{releaseId}/featureFlags
  • Auth
    API key in header X-API-Key

Path parameters

appIdstring required

The id of the app

releaseIdstring required

The id of the release. Constructed from the app's id and the release version like so: {appId}:{version}. For the GET single release endpoint, the following keywords are also accepted: live (latest completed release), next or current (current active release).

Response

A list of feature flags for a release

idstring

The feature flag's unique id. Use this with the toggle endpoint to enable or disable the flag.

namestring

The human-readable name of the feature flag.

descriptionstring nullable

An optional description of the feature flag.

createdAtstring date-time

When the flag was created.

updatedAtstring date-time nullable

When the flag was last updated.

enabledAtstring date-time nullable

When the flag was enabled, if applicable.

isEstimatedEnabledAtboolean

Whether enabledAt is an estimate rather than an exact timestamp.

estimatedDisabledAtstring date-time nullable

The estimated time the flag was disabled, if applicable.

minimumVersionstring nullable

The minimum app version the flag targets, if version-scoped.

maximumVersionstring nullable

The maximum app version the flag targets, if version-scoped.

equalVersionsstring[]

Specific app versions the flag targets.

rolloutPercentagenumber nullable

The percentage of users the flag is rolled out to, if applicable.

status'enabled' | 'disabled' | 'archived' | 'paused'

The current status of the flag.

type'featureFlagOptimizelyExperiment' | 'featureFlagOptimizelyFeature' | 'featureFlagOptimizelyFlag' | 'featureFlagLaunchDarklyFlag' | 'featureFlagStatsigGate' | 'featureFlagStatsigDynamicConfig' | 'featureFlagFirebaseRemoteConfigParam' | 'featureFlagFirebaseRemoteConfigBoolParam' | 'featureFlagAmplitudeExperimentFlag' | 'featureFlagAmplitudeExperimentExperiment' | 'featureFlagUnleashFeature'

The provider-specific type of the flag.

ownerstring nullable

The owner of the flag, if set in the provider.

platformsstring[]

The platforms the flag applies to.

urlstring nullable

A link to the flag in the provider's dashboard, if available.

isReadOnlyboolean

Whether the flag is read-only. Read-only flags cannot be enabled or disabled via the toggle endpoint.

isNewlyEnabledInThisVersionboolean

Whether the flag was newly enabled in this release version.

isNewlyDisabledInThisVersionboolean

Whether the flag was newly disabled in this release version.

isSpecificallyTargetingThisVersionboolean

Whether the flag specifically targets this release version.

isSpecificallyNotTargetingThisVersionboolean

Whether the flag specifically excludes this release version.

didChangeInThisVersionboolean

Whether the flag changed in this release version.

shouldHighlightboolean

Whether the UI should highlight this flag.

highlightTooltipTextstring

The tooltip text to show when the flag is highlighted.

Changes

No recorded changes to this operation across all 1 revision of this API.