Edit api creation docs to reflect correct CLI usage

[jwlodek]

Checklist

• Add a Changelog entry
• Add the ticket number which this PR closes to the comment section (N/A)

Currently, if the docs are followed, we get a typer error:

(2024-2.3-py311-tiled) [jwlodek@xf31id1-ws3 ~]$ tiled api_key create --scopes read:metadata read:data --profile nsls2
Usage: tiled api_key create [OPTIONS]
Try 'tiled api_key create --help' for help.
╭─ Error ───────────────────────────────────────────────────────────────────────────────────────────╮
│ Got unexpected extra argument (read:data)                                                         │
╰───────────────────────────────────────────────────────────────────────────────────────────────────╯

This is because list arguments with typer work by using the same flag multiple times. I.e:

tiled api_key create --scopes read:metadata --scopes read:data --profile nsls2

If you run the above, it works as expected. My guess is that it is possible that this may need to be fixed in the docs in other places as well for other List CLI args.

[danielballan]

Thanks @jwlodek. Fortunately this seems to be the only instance of this mistake in the code:

$ git grep -e "--scopes"
docs/source/how-to/api-keys.md:$ tiled api_key create --expires-in 600 --scopes read:metadata
docs/source/how-to/api-keys.md:$ tiled api_key create --note="Data validation pipeline" --scopes read:metadata read:data

[danielballan]

...Not to say that there aren't other list parameters...but this was a typo not a conceptual confusion on my part, so I'm hopeful. I'll keep an eye out.