---
id: workflows
title: Workflows
description: >-
  Build, publish, run, and observe workflows on the nullplatform workflow
  engine.
sidebar_label: Introduction
sidebar_position: 0
hide_title: true
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflows'
---
<span
  className={"theme-doc-version-badge badge badge--secondary"}
  children={"Version: 0.1.0"}
>
</span>

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Workflows"}
>
</Heading>

Build, publish, run, and observe workflows on the nullplatform workflow engine.

Four ideas organize this API:

- **Definitions** are the workflow documents. Every save becomes a numbered **revision**, so nothing is ever lost.
- **Aliases** are named pointers to a revision (like `live`). Activating an alias is what turns its triggers on.
- **Executions** record every run, step by step, with inputs, outputs, and logs.
- **Secrets and variables** keep credentials and settings out of the definition.

<div
  style={{"marginBottom":"2rem"}}
>
  <Heading
    id={"authentication"}
    as={"h2"}
    className={"openapi-tabs__heading"}
    children={"Authentication"}
  >
  </Heading><SchemaTabs
    className={"openapi-tabs__security-schemes"}
  >
    **HTTP: Bearer Auth**

      <div>
        <table>
          <tbody>
            <tr>
              <th>
                Security Scheme Type:
              </th><td>
                http
              </td>
            </tr><tr>
              <th>
                HTTP Authorization Scheme:
              </th><td>
                bearer
              </td>
            </tr><tr>
              <th>
                Bearer format:
              </th><td>
                JWT
              </td>
            </tr>
          </tbody>
        </table>
      </div>

  </SchemaTabs>
</div>
