BAbannerbear

Create a workflow

Changed on

Create a workflow with its inputs and steps in one call. Every step's ref is validated against its adapter — an unknown tool slug or a template UID outside this workspace is rejected — and a step may only reference steps before it.

post/workflows

Request

  • Base URL
    https://api.bannerbear.com/v5
  • Auth
    HTTP bearer

Request body

namestring required
descriptionstring nullable
tagsstring[]
inputsobject

Inputs the workflow accepts, keyed by name. Omit to leave the existing inputs untouched; send {} to clear them.

Response

Workflow created

uidstring
namestring
descriptionstring nullable
tagsstring[]
inputsobject

Inputs this workflow accepts, keyed by name. Each value is { type, required }. url-typed inputs are validated as http(s) URLs when a run is created.

ui_write_access'owner_only' | 'team'
api_write_access'team' | 'owner_only' | 'nobody'

Who may run this workflow via the API

created_atstring date-time

Changes