releases.shpreview

Flagship API reference now available

1 featureThis release1 featureNew capabilitiesAI-tallied from the release notes

The Flagship API reference is now available. You can use the Cloudflare API to create and update apps, and to create, update, delete, and list feature flags without using the dashboard.

For example, create a new boolean flag with the API:

<div><div><span>curl</span><span> </span><span>https://api.cloudflare.com/client/v4/accounts/</span><span>$ACCOUNT_ID</span><span>/flagship/apps/</span><span>$APP_ID</span><span>/flags</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-H</span><span> </span><span>"Content-Type: application/json"</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-H</span><span> </span><span>"Authorization: Bearer </span><span>$CLOUDFLARE_API_TOKEN</span><span>"</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-d</span><span> </span><span>'{</span></div></div><div><div><span><span>    </span></span><span>"key": "new-checkout",</span></div></div><div><div><span><span>    </span></span><span>"enabled": true,</span></div></div><div><div><span><span>    </span></span><span>"default_variation": "off",</span></div></div><div><div><span><span>    </span></span><span>"variations": {</span></div></div><div><div><span><span>      </span></span><span>"off": false,</span></div></div><div><div><span><span>      </span></span><span>"on": true</span></div></div><div><div><span><span>    </span></span><span>},</span></div></div><div><div><span><span>    </span></span><span>"rules": []</span></div></div><div><div><span><span>  </span></span><span>}'</span></div></div>

To create an API token, go to Account API Tokens in the Cloudflare dashboard and search for Flagship.

The API reference includes endpoints for Flagship apps, flags, changelog entries, and flag evaluation. Agents can also use the Flagship reference in the Cloudflare skill to create and manage Flagship resources.

Refer to the Flagship documentation to learn more about evaluating feature flags from your applications.

Fetched June 12, 2026