Triggers a new build, returns a summary of the build in CircleCI
A documented CircleCI operation that changes something in your account. Describe the outcome you want in plain words — HumDay writes the program, proves it, and runs it.
What this operation does
Triggers a new build, returns a summary of the build.
- POSTChanges data
circleci.com/project/{username}/{project}
How HumDay uses it
- You describe the outcome. Not this operation by name — what you want to happen. HumDay works out which operations it needs.
- The contract names it. Before anything is built, you see exactly which CircleCI operations the program may use, and this is one of them.
- You approve access. Because this one changes data, it cannot run until you have explicitly granted it.
Other CircleCI operations
- Adds your Heroku API key to CircleCIPOST · changes data
- Creates a new environment variablePOST · changes data
- Creates a new checkout keyPOST · changes data
- Create an ssh key used to access external systemsPOST · changes data
- Triggers a new build, returns a summary of the buildPOST · changes data
- Retries the build, returns a summary of the new buildPOST · changes data
- Clears the cache for a projectDELETE · changes data
- Deletes the environment variable named ':name'DELETE · changes data
Questions
- Can HumDay triggers a new build, returns a summary of the build in CircleCI?
- Yes. This operation is published in CircleCI's own API description, so HumDay can use it without a hand-built connector — once you have approved it for your automation.
- Will this change my CircleCI data?
- Yes — this is a POST operation, so it changes something in CircleCI. HumDay holds anything that writes behind an approval you grant explicitly, and the contract you approve says what it may touch.
- Do I need to write code?
- No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a proof run before anything touches your CircleCI account.
Where this came from
Read from a published API description for CircleCI at raw.githubusercontent.com/kamikazechaser/spec-circleci/master/swagger.yml. The description above is the provider’s own wording, not ours. Last published 2021-06-21.