| name | awin-cli |
| description | Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute awin operations using the `awin` CLI tool. Awin Publisher API CLI -- list publisher accounts and advertiser programmes via Bearer token auth. Triggers: awin, awin cli, awin publisher, awin programmes, awin advertisers, list awin programs, awin affiliate, awin api. |
Execute Awin Publisher API operations using the `awin` CLI. All Awin
publisher and programme interactions should use this CLI.
<quick_start>
The awin CLI follows this pattern:
awin <command-group> <action> [arguments] [options]
| Task | Command |
|---|
| Authenticate | awin auth login |
| Check auth | awin auth status |
| List publisher accounts | awin publishers list |
| Get one publisher | awin publishers get PUBLISHER_ID |
| List joined programmes | awin programmes list |
| List unjoined programmes | awin programmes list --relationship notjoined |
| Get one programme | awin programmes get PROGRAMME_ID |
| Clear cached responses | awin cache clear |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY awin command. It contains complete command syntax, arguments, options, and usage instructions.
Awin uses Bearer token authentication. Generate the token at
https://ui.awin.com/awin-api and run `awin auth login`. You will be
prompted for the token AND your numeric Awin Publisher ID.
List commands support `--limit/-l`, `--filter/-f`, `--properties/-p`, and `--table/-t`. JSON is the default on stdout.
<reference_index>
usage.json — Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
