[tomasr78]

What

The "Alternative domain" example in README.md passed a URL as the host:

let convertApi = ConvertApi.auth('api-token', 'https://eu-v2.convertapi.com/')

The library expects a bare host name. It builds request URLs as https://${this.host}/convert/... (src/convertapi.ts)
and https://${this.host}/upload?... (src/file-param.ts). With the README's value, every request went to
https://https://eu-v2.convertapi.com//convert/.... The URL parser reads https as the host, so the request fails
with TypeError: fetch failed (ENOTFOUND). The example has been wrong since it was added on 2023-07-04 in
93fa8fe; the library
already prefixed https:// then.

This PR changes the example to

let convertApi = ConvertApi.auth('api-token', 'eu-v2.convertapi.com')

and rewrites the sentence above it. The sentence now says that the second argument is a host name without https://
or a trailing slash, that the default is v2.convertapi.com, and where the regional hosts are listed. The change is
in README.md only; the code is unchanged.

Checks

• https://www.convertapi.com/docs/servers-location lists eight hosts: v2, uk-v2, eu-v2, us-v2, ca-v2,
  as-v2, jp-v2 and au-v2 (all .convertapi.com). On 2026-11-12 all eight resolved and answered the API
  (401 without credentials). The README names only v2.convertapi.com and eu-v2.convertapi.com.
• node --test test/live.test.js with a staging token and CONVERT_API_HOST=stag-v2.convertapi.com, a bare host:
  3 of 3 pass.
• The README's line, run against eu-v2 with an invalid token:
  • new form: the API answers with error 4011, "Unauthorized. Invalid or missing API credentials."
  • old form: fetch failed (ENOTFOUND https), before any request reaches ConvertAPI.
• test/convertapi.test.js already passes a bare host ('example.test').
• No conflict with Publish stable releases under the npm dist-tag latest #33, which adds one line near the top
  of README.md (checked with git merge-tree). Either PR can merge first.

The same mistake on convertapi.com

• https://www.convertapi.com/llms.txt repeats the old example on line 534, under "Using a regional endpoint". It
  needs its own fix on the site; this PR does not change it.
• The JavaScript snippets on https://www.convertapi.com/integrations/libraries/javascript and on the converter
  pages are fine: their template calls ConvertApi.auth('{{secret}}') with no host. The pages under
  https://www.convertapi.com/docs have no JavaScript SDK code.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

There are no active review issues for this README-only change clarifying the regional host argument format.

No open issues 🎉

What changed in this PR

Corrects the README’s regional-server example to match the host-name format expected by ConvertApi.auth. No library code changes.

Changes:

• Removes https:// and the trailing slash from the example host.
• Clarifies the second argument’s format, documents the default host, and retains the link to regional server locations.

File	Description
README.md	Fixes the regional-host example and clarifies host argument requirements.

_{Review effort: Balanced}