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:
| Field | Description |
|---|---|
name | Display name of the action |
description | Purpose and details of the workflow |
provider | The orchestration system used (e.g. GITHUB_ACTIONS) |
parameterSchema | JSON schema defining required input parameters |
owners | Users who can manage and edit the action |
actors | Users allowed to run the action |
approvers | Users 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
| Role | What they can do |
|---|---|
| Owner | Edit or delete the action |
| Actor | Run the action |
| Approver | Approve or reject individual runs |