How to programmatically manage the "Setup Workflows" setting


Before you can use dynamic config in CircleCI, you need to  toggle on the "Enable dynamic config using setup workflows" setting, in your Advanced project settings, in the CircleCI UI.


However, it is also possible to perform this operation via the CircleCI API v1.


Prerequisites (If Applicable):

If you don't already have one that you can use, you'll need to generate a personal API token for a user who has, at least, write access on the related project..


  1. Retrieve the personal API token (see prerequisites)
  2. Programmatically enable the setting 
    • The following example uses cURL+shell but you can wrap the API call and use it with your favourite language.
      curl --location --request PUT '<VCS>/<ORG_NAME>/<NEW_REPO_NAME>/settings' \

      --header 'Content-Type: application/json' \

      --header 'Circle-Token: <API_TOKEN>' \

      --data-raw '{

      "feature_flags":{"setup-workflows": true}



If the operation is successful, you'll receive a 200 response.


Additional Notes:

You can programmatically disable the setting by replacing true with false in the above sample request.


Additional Resources:

Links to related knowledge base articles or how-tos that prove most relevant. Make sure to click "Open in New Tab" when adding resources

Was this article helpful?
0 out of 1 found this helpful



Article is closed for comments.