Create a Turso Cloud database (libSQL) via the Platform API or CLI and retrieve its connection URL

Documented steps

1. Decide control plane: CLI (interactive/dev) or Platform API (automation). CLI install: `curl -sSfL https://get.tur.so/install.sh | bash` or `brew install tursodatabase/tap/turso` (https://docs.turso.tech/cli/installation). Then `turso auth login` (`--headless` in CI/WSL).
2. For API automation, mint a Platform API token: `turso auth api-tokens mint <name>` — this is the CONTROL-plane token and is different from a database auth token (https://docs.turso.tech/api-reference/authentication).
3. A database must live in a group. List groups: GET https://api.turso.tech/v1/organizations/{organizationSlug}/groups. Create one if needed: POST https://api.turso.tech/v1/organizations/{organizationSlug}/groups with body {"name":"default","location":"<3-letter region code>"} (https://docs.turso.tech/api-reference/groups/create).
4. Create the database: POST https://api.turso.tech/v1/organizations/{organizationSlug}/databases with header `Authorization: Bearer <platform-api-token>` and body {"name":"my-db","group":"default"}. Optional: "size_limit" (e.g. "1gb"), "seed" ({"type":"database"|"database_upload","name":...,"timestamp":...}), "remote_encryption" (https://docs.turso.tech/api-reference/databases/create).
5. Read the response: {"database":{"DbId":...,"Hostname":...,"Name":...}}. The Hostname is what you connect to.
6. CLI equivalent: `turso db create my-db --group default` (flags: --from-db, --from-file, --from-dump, --from-csv, --size-limit, --enable-extensions, -w/--wait) (https://docs.turso.tech/cli/db/create).
7. Get the connection URL: `turso db show my-db --url` for the libsql:// URL, `--http-url` for the https:// form (https://docs.turso.tech/cli/db/show). URL shape is https://[databaseName]-[organizationSlug].turso.io.
8. Mint a DATA-plane auth token before connecting: `turso db tokens create my-db` or POST /v1/organizations/{org}/databases/{db}/auth/tokens.
9. Verify: GET https://api.turso.tech/v1/organizations/{organizationSlug}/databases and confirm the new name appears (https://docs.turso.tech/api-reference/databases/list).