Skip to main content

Actions

An Action is a reusable workflow definition in PlatformWorks Hub. It defines:

  • The orchestration provider to use (e.g. GitHub Actions)
  • The parameters required to execute the workflow
  • The users involved: actors, approvers, and owners

Structure of an Action

Each action consists of:

FieldDescription
nameDisplay name of the action
descriptionPurpose and details of the workflow
providerThe orchestration system used (e.g. GITHUB_ACTIONS)
parameterSchemaJSON schema defining required input parameters
ownersUsers who can manage and edit the action
actorsUsers allowed to run the action
approversUsers who must approve a run before execution (if required)

Example Use Cases

  • Provision Database – Creates a new RDS instance in AWS
  • Create GitHub Repo – Scaffolds a service from a template
  • Reset DB Password – Rotates credentials securely with audit trail

Permissions

RoleWhat they can do
OwnerEdit or delete the action
ActorRun the action
ApproverApprove or reject individual runs