BETA

Create an API token

How-to2 min readUpdated July 2026

API tokens let scripts, the CLI, Terraform and CI pipelines talk to netplex. without your password. Tokens are scoped - grant only what the automation needs - and revocable at any time.

1

Open Settings → API Tokens. Existing tokens are listed with their scopes and last-used time; revoking one takes effect immediately.

Step 1: Create an API token
2

Create a token with a descriptive name and the smallest scopes that work - a CI pipeline that runs labs needs lab scopes, not admin. The secret is shown once at creation: copy it straight into your secret manager.

Step 2: Create an API token

Use the token as a Bearer header (Authorization: Bearer <token>) against /api/v1/…, or drop it into the CLI/Terraform provider configuration. Scope enforcement is server-side - a lab-scoped token cannot touch admin endpoints.