Skip to content
tcli

AW Workflow Handlers

See the config-artifact guide for how to add, register, and deploy workflow handler definitions. This page covers how to name them.

Active Workspace workflow handler definitions live flat in configuration/aw_workflow_handlers as .json files. Their names follow a fixed scheme that tcli lint enforces:

<PREFIX>-<handler-name>.json
  • <PREFIX> is a project/customisation prefix made of uppercase letters and digits only. It may be empty.
  • A single hyphen (-) separates the prefix from the handler name.
  • <handler-name> is lower-kebab-case: it starts with a lowercase letter and uses hyphens between words.

Valid examples:

MY-set-status.json
ACME-release-item.json

Invalid examples:

MY_set_status.json     # underscores are not allowed
my-set-status.json     # the prefix must be uppercase/digits (or empty)
MY-Set-Status.json     # the handler name must be lowercase