--- title: Flagship --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/terraform) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Flagship #### FlagshipApps #### resource cloudflare\_flagship\_app ##### required Expand Collapse account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20account_id>) name: String Name of the Flagship app (1–64 letters, numbers, hyphens, or underscores). [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20name>) ##### computed Expand Collapse id: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>) created\_at: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20created_at>) updated\_at: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20updated_at>) updated\_by: String Email of the actor who last modified the app, or `unknown` when unavailable. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20updated_by>) ### cloudflare\_flagship\_app Terraform HTTPTypeScriptPythonGoTerraform ``` resource "cloudflare_flagship_app" "example_flagship_app" { account_id = "account_id" name = "x" } ``` #### data cloudflare\_flagship\_app ##### required Expand Collapse app\_id: String Flagship app ID returned when the app was created. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20app_id>) account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>) ##### computed Expand Collapse id: String Flagship app ID returned when the app was created. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>) created\_at: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20created_at>) name: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20name>) updated\_at: String [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20updated_at>) updated\_by: String Email of the actor who last modified the app, or `unknown` when unavailable. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20updated_by>) ### cloudflare\_flagship\_app Terraform HTTPTypeScriptPythonGoTerraform ``` data "cloudflare_flagship_app" "example_flagship_app" { account_id = "account_id" app_id = "app_id" } ``` #### data cloudflare\_flagship\_apps ##### required Expand Collapse account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20account_id>) ##### optional Expand Collapse max\_items?: Int64 Max items to fetch, default: 1000 [Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>) ##### computed Expand Collapse

result: List\[Attributes] The items returned by the data source

id: String Link to this property created\_at: String Link to this property name: String Link to this property updated\_at: String Link to this property updated\_by: String Email of the actor who last modified the app, or unknown when unavailable. Link to this property

[Link to this property](<#(resource)%20flagship.apps%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>) ### cloudflare\_flagship\_apps Terraform HTTPTypeScriptPythonGoTerraform ``` data "cloudflare_flagship_apps" "example_flagship_apps" { account_id = "account_id" } ``` #### FlagshipAppsFlags #### resource cloudflare\_flagship\_flag ##### required Expand Collapse key: String Unique identifier for the flag within an app. Used in all evaluation and SDK calls. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20key>) account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20account_id>) app\_id: String Flagship app ID returned when the app was created. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20app_id>) default\_variation: String Variation the API serves when the flag is off, or when it’s on but no rule matches the context. Must be a key in `variations`. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20default_variation>) enabled: Bool When false, the flag bypasses all rules and always serves `default_variation`. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20enabled>) variations: Map\[String] Map of variation name to value. All values share the same type (boolean, string, number, or JSON object/array), and each serialized value stays within 10KB. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variations>)

rules: List\[Attributes] Targeting rules evaluated in ascending priority; the first matching rule wins. An empty array means the flag always serves default_variation.

conditions: List\[Attributes] Conditions the context must satisfy for this rule to match. An empty array matches all contexts.

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property

clauses?: List\[Attributes]

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property

clauses?: List\[Attributes]

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property

clauses?: List\[Attributes]

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property

clauses?: List\[Attributes]

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property

clauses?: List\[Attributes]

attribute?: String Link to this property operator?: String Link to this property value?: String Link to this property clauses?: List\[String] Link to this property logical\_operator?: String Link to this property

Link to this property logical\_operator?: String Link to this property

Link to this property priority: Int64 Evaluation order: the API evaluates rules with lower numbers first. Must be unique across the flag’s rules. Link to this property serve\_variation: String Variation the API serves when this rule matches. Must be a key in variations. Link to this property

rollout?: Attributes

percentage: Float64 Percentage of matching traffic (0–100, up to 2 decimal places) served this variation. For multi-way splits, use cumulative upper bounds across rules (e.g. 30, 70, 100). Link to this property attribute?: String Context attribute used for sticky bucketing. Defaults to targetingKey. If absent at evaluation time, bucketing is random per request. Link to this property

Link to this property

[Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20rules>) ##### optional Expand Collapse description?: String Optional operator-facing description. It does not affect flag evaluation. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20description>) Deprecatedtype?: String Deprecated compatibility field. Omit it; the API ignores this value and infers the type from the flag’s variations. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20type>) ##### computed Expand Collapse id: String Unique identifier for the flag within an app. Used in all evaluation and SDK calls. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>) updated\_at: String [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20updated_at>) updated\_by: String [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20updated_by>) ### cloudflare\_flagship\_flag Terraform HTTPTypeScriptPythonGoTerraform ``` resource "cloudflare_flagship_flag" "example_flagship_flag" { account_id = "account_id" app_id = "app_id" default_variation = "x" enabled = true key = "x" rules = [{ conditions = [{ attribute = "x" operator = "equals" value = "string" }] priority = 1 serve_variation = "x" rollout = { percentage = 0 attribute = "x" } }] variations = { foo = "string" } description = "description" type = "boolean" } ``` #### data cloudflare\_flagship\_flag ##### required Expand Collapse account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>) app\_id: String Flagship app ID returned when the app was created. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20app_id>) ##### optional Expand Collapse flag\_key?: String Case-sensitive key identifying the flag within the app. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20flag_key>)

filter?: Attributes

limit?: Int64 Max items to return (1–200). Link to this property

[Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20filter>) ##### computed Expand Collapse id: String Case-sensitive key identifying the flag within the app. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>) default\_variation: String Variation the API serves when the flag is off, or when it’s on but no rule matches the context. Must be a key in `variations`. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20default_variation>) description: String Optional operator-facing description. It does not affect flag evaluation. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20description>) enabled: Bool When false, the flag bypasses all rules and always serves `default_variation`. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20enabled>) key: String Unique identifier for the flag within an app. Used in all evaluation and SDK calls. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20key>) type: String Server-inferred value type shared by all of the flag’s variations. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20type>) updated\_at: String [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20updated_at>) updated\_by: String [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20updated_by>) variations: Map\[String] Map of variation name to value. All values share the same type (boolean, string, number, or JSON object/array), and each serialized value stays within 10KB. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variations>)

rules: List\[Attributes] Targeting rules evaluated in ascending priority; the first matching rule wins. An empty array means the flag always serves default_variation.

conditions: List\[Attributes] Conditions the context must satisfy for this rule to match. An empty array matches all contexts.

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property clauses: List\[String] Link to this property logical\_operator: String Link to this property

Link to this property logical\_operator: String Link to this property

rollout: Attributes

percentage: Float64 Percentage of matching traffic (0–100, up to 2 decimal places) served this variation. For multi-way splits, use cumulative upper bounds across rules (e.g. 30, 70, 100). Link to this property attribute: String Context attribute used for sticky bucketing. Defaults to targetingKey. If absent at evaluation time, bucketing is random per request. Link to this property

Link to this property

[Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20rules>) ### cloudflare\_flagship\_flag Terraform HTTPTypeScriptPythonGoTerraform ``` data "cloudflare_flagship_flag" "example_flagship_flag" { account_id = "account_id" app_id = "app_id" flag_key = "flag_key" } ``` #### data cloudflare\_flagship\_flags ##### required Expand Collapse account\_id: String Cloudflare account ID that owns the Flagship app. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20account_id>) app\_id: String Flagship app ID returned when the app was created. [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20app_id>) ##### optional Expand Collapse limit?: Int64 Max items to return (1–200). [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20limit>) max\_items?: Int64 Max items to fetch, default: 1000 [Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>) ##### computed Expand Collapse

result: List\[Attributes] The items returned by the data source

id: String Unique identifier for the flag within an app. Used in all evaluation and SDK calls. Link to this property default\_variation: String Variation the API serves when the flag is off, or when it’s on but no rule matches the context. Must be a key in variations. Link to this property enabled: Bool When false, the flag bypasses all rules and always serves default_variation. Link to this property key: String Unique identifier for the flag within an app. Used in all evaluation and SDK calls. Link to this property

rules: List\[Attributes] Targeting rules evaluated in ascending priority; the first matching rule wins. An empty array means the flag always serves default_variation.

conditions: List\[Attributes] Conditions the context must satisfy for this rule to match. An empty array matches all contexts.

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

attribute: String Link to this property operator: String Link to this property value: String Link to this property

clauses: List\[Attributes]

Link to this property logical\_operator: String Link to this property

rollout: Attributes

percentage: Float64 Percentage of matching traffic (0–100, up to 2 decimal places) served this variation. For multi-way splits, use cumulative upper bounds across rules (e.g. 30, 70, 100). Link to this property attribute: String Context attribute used for sticky bucketing. Defaults to targetingKey. If absent at evaluation time, bucketing is random per request. Link to this property

Link to this property

Link to this property type: String Server-inferred value type shared by all of the flag’s variations. Link to this property variations: Map\[String] Map of variation name to value. All values share the same type (boolean, string, number, or JSON object/array), and each serialized value stays within 10KB. Link to this property description: String Optional operator-facing description. It does not affect flag evaluation. Link to this property updated\_at: String Link to this property updated\_by: String Link to this property

[Link to this property](<#(resource)%20flagship.apps.flags%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>) ### cloudflare\_flagship\_flags Terraform HTTPTypeScriptPythonGoTerraform ``` data "cloudflare_flagship_flags" "example_flagship_flags" { account_id = "account_id" app_id = "app_id" limit = 1 } ```