/v1/workflowsStart a workflow draft
Creates a workflow as a DRAFT. It is deliberately NOT validated and it never runs — nothing executes until post_workflows_id_publish freezes it as a version, so saving a half-written rule here is safe and expected. Body: name (required), optional description, optional key — lowercase letters, digits, - and _, starting with a letter or digit, at most 63 characters, unique per workspace (a second one is a 409); left out, it is made from the name — and definition as {trigger, steps}, whose vocabulary comes from get_workflows_catalog. To find out whether what you wrote would run, post_workflows_validate. A record-event trigger's definitions — a LIST of page or board keys, "definitions": ["board-…"] — limits it to records on those; left out, it fires for records on every page and board.
Access class: workspace:admin.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"createdAt": "2026-01-01T00:00:00Z",
"createdByUserId": 1,
"definition": "string",
"description": "string",
"id": 1,
"key": "string",
"name": "string",
"publishedAt": "2026-01-01T00:00:00Z",
"runAsAccountId": "",
"status": "string",
"updatedAt": "2026-01-01T00:00:00Z",
"version": 1
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}