> For the complete documentation index, see [llms.txt](https://pedal.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pedal.gitbook.io/docs/cli/workflow-syntax.md).

# Workflow Syntax

Define PEDAL workflows using YAML or JSON.

## pedal.yaml Schema

* `name`: Workflow name
* `triggers`: Events that start the workflow (e.g., github\_push, schedule)
* `steps`: List of actions to perform
* `dependencies`: Specify step dependencies (optional)

## Triggers

* `github_push`: GitHub push event
* `schedule`: Cron schedule (e.g., "0 2 \* \* \*")
* `manual`: User-initiated
* `webhook`: External event

## Steps

* `run`: Execute a command or script
* `notify`: Send a notification (e.g., Slack)
* `deploy`: Deploy to a target environment

## Dependencies

* Use `depends_on` to specify step order

## JSON Alternative

* Workflows can also be defined in JSON format

***

> For glossary, see [Glossary](/docs/cli/glossary.md)