Aliases
An alias is a short name bound to one thing you can run: an app action, a Function, a Workflow or an Endpoint. Scripts then run it by name instead of by id, and you can point the name somewhere else later without changing the scripts.
Where to find it: aliases aren’t in the settings list. Open
https://<your-studio-host>/<account-id>/<project-id>/settings/aliasesdirectly. The page may change.
Create an alias
- Open the Aliases page and click + New alias.
- Under Identity, enter a Name in lowercase kebab-case, such as
send-email. You can’t change it after saving. Optionally add a Display name and Description. - Under Target, choose Action, Function, Workflow or Endpoint, and pick the one this alias runs.
- Click Save alias.
How you know it worked: Saved. appears, and the alias is listed under Registered aliases. Run it shows the command to call it:
w6w run send-email --payload '{"to": "ada@example.com"}'See CLI.
A Function or action target answers with its result; a Workflow target starts a run.
Change or delete an alias
- Open it, pick a different Target and click Save alias. Everything that calls the name now runs the new target.
- Click Delete and confirm Delete alias. Anything that still calls the name fails straight away.
Troubleshooting
| Symptom | Cause | What to do |
|---|---|---|
Name this alias before saving. | Name is empty. | Enter a name. |
Pick a target for this alias before saving. | No target is chosen. | Choose one under Target. |
w6w run <name> says it’s not found | The name is misspelled, or the alias is in another project. | Check Registered aliases in the project your token uses. |