Skip to content

Commit 75000a9

Browse files
Customer.io Open Source Botgithub-actions[bot]
authored andcommitted
Add Customer.io CLI source
CioCliPublicExport-RevId: 7001cd89e3108b1983b536ac701092d41ba89d5f
1 parent 4b6feb2 commit 75000a9

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

cmd/prime_context.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,25 @@ cio auth status
1818

1919
If 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

2342
The 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

Comments
 (0)