Create a workflow
POST/workflows/definitions
Creates a workflow. The request body is the definition document itself, not wrapped in any envelope.
- The workflow starts at revision 1, with the auto-maintained
latestalias pointing at it. - Nothing runs yet: triggers only register when you activate an alias.
- Referencing secrets or variables that have no value yet is fine: creation succeeds and the response lists them under
warningsso you can set them afterwards.
Request
Responses
- 201
- 4XX
- 5XX
The workflow was created.
Client error. The body says what went wrong: an error type, a human-readable detail, and, on validation failures, one entry per offending field.
Unexpected server error.