Access requirements

The Authorization Bearer (Admin API Key authorizing the request) must have one of the following roles and scopes:

Admin API Key roles accepted

API_ALL_GRANTED
API_FEATURE_FLAG_EDITOR

Admin API Key scopes accepted

GLOBAL
WORKSPACE

Project (Workspace) View restrictions may apply to this API.

To learn more about Admin API Key roles and scopes, see API keys overview.

JSON Payload Posted

{
 "name": String, // Mandatory
 "description": String, // Optional
 "owners": [ // Optional
      {
        "id": String,
        "type": String
      }
    ]
}

Note: Owners are treated as metadata to help identify responsible stakeholders and filter feature flags. Owners are not automatically granted edit permissions. To manage who can edit a resource, use environment-level permissions or configure explicit editors.

The owners field specifies users or teams responsible for the feature flag. Each owner object requires an id and a type.

type must either be User or Team.
id must correspond to an existing user or team in the project (or workspace).
The _project_all_users team ID represents the All Project Users owner available in the FME UI.

For example:

{
  "name": "paywall_beta",
  "description": "description",
  "owners": [
    {
      "id": "EvGB7BeOTAWilAUxLcFlgA",
      "type": "User"
    },
    {
      "id": "_project_all_users",
      "type": "Team"
    }
  ]
}

If an invalid owner is provided, the API returns a 400 Invalid Owner response.

200200

401401

403403

404404

409409