@@ -18,6 +18,25 @@ cio auth status
1818
1919If auth fails, ask the user to run ` cio auth login ` and paste their ` sa_live_ ` token.
2020
21+ ## Profiles
22+
23+ Credentials live in named profiles (in ` ~/.cio/config.json ` ), each with its own
24+ token, region, and optional API base URL. This lets one machine hold several
25+ accounts (e.g. production, staging, a client) without re-authenticating.
26+
27+ ``` bash
28+ cio profile list # list profiles; the saved default is marked current
29+ cio profile use < name> # set the default profile
30+ cio profile remove < name> # delete a profile
31+ cio auth login --profile < name> # create/re-auth a profile (persists a custom --api-url)
32+ ```
33+
34+ Select a profile for a single command with the global ` --profile <name> ` flag,
35+ or for a whole session with the ` CIO_PROFILE ` env var. Resolution order:
36+ ` --profile ` → ` CIO_PROFILE ` → stored ` current_profile ` → ` default ` . A legacy
37+ single-credential config is migrated to a ` default ` profile automatically.
38+ Profile names allow letters, digits, ` . ` , ` - ` , and ` _ ` .
39+
2140## The ` api ` Command
2241
2342The primary command is ` cio api <path> ` . It makes authenticated HTTP requests to supported Customer.io API endpoints.
@@ -82,6 +101,7 @@ cio skills read design-studio/nodes.md # node creation, component markup
82101| ` --scope <value> ` | Request additional OAuth scopes during token exchange |
83102| ` --api-url <url> ` | Override the API base URL |
84103| ` --token <value> ` | Override the service account token |
104+ | ` --profile <name> ` | Configuration profile to use (overrides ` CIO_PROFILE ` ; default: current profile) |
85105| ` --page <n> ` | Page number |
86106| ` --limit <n> ` | Page size |
87107| ` --page-all ` | Auto-paginate, emit NDJSON (one JSON object per line) |
0 commit comments