Skip to content

POMA SDK Authentication (v2)

The SDK reads your account API key from POMA_API_KEY. You provision that key once in the POMA Console — no curl, no JWT bootstrap, no API calls.

Generate an API key in the Console

  1. Open the POMA Console and sign in (or create a free account).
  2. Go to Account.
  3. In the API Key card on the right, click Generate API key. Copy the value — it's shown once.

Need to call /generateApiKey directly (CI, automation)? The raw HTTP flow lives in the POMA API v3 reference. The Console is the supported path for human-operated account setup.

Wire it into the SDK

bash
export POMA_API_KEY="poma_acc_…"
powershell
setx POMA_API_KEY "poma_acc_…"

On Windows, open a new terminal after running setx.

python
from poma import PrimeCut

client = PrimeCut()  # reads POMA_API_KEY

Or pass the key explicitly:

python
client = PrimeCut(api_key="poma_acc_…")

Optional environment variables

The SDK also respects API_BASE_URL for pointing at a non-default POMA API base URL.

Lost the key?

Open the Console → AccountGenerate API key again. The new key takes effect immediately; the old one stops working.