Skip to main content
PUT
/
feature-flags
/
v3
/
{appId}
/
flags
/
{flagName}
Set an app's feature flag
curl --request PUT \
  --url 'https://api.hubapi.com/feature-flags/v3/{appId}/flags/{flagName}?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "defaultState": "ABSENT",
  "overrideState": "ABSENT"
}
'
{
  "appId": 123,
  "defaultState": "ABSENT",
  "flagName": "<string>",
  "overrideState": "ABSENT"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free

Authorizations

hapikey
string
query
required

Path Parameters

appId
integer<int32>
required

The ID of the app.

flagName
string
required

The name of the flag, either hs-release-app-cards or hs-hide-crm-cards.

Body

application/json
defaultState
enum<string>
required

The state that the flag should have if there are no overrides for a particular portal

Available options:
ABSENT,
OFF,
ON
overrideState
enum<string>

A flag value that supercedes all other overrides, including portal-level values. Mostly used for things like emergency overrides

Available options:
ABSENT,
OFF,
ON

Response

successful operation

appId
integer<int32>
required

The ID of the app

defaultState
enum<string>
required

The flag state for any portal that doesn't have an override value

Available options:
ABSENT,
OFF,
ON
flagName
string
required

The name of the flag

overrideState
enum<string>

An optional flag value that overrides all others for this flag name and app, including portal-level values

Available options:
ABSENT,
OFF,
ON