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.