Admin API Keys

Manage programmatic access to your Validation Cloud account and data.

Using Claude Code or another AI harness like Codex? You can interact with the Admin API using our skills & plugins. Visit https://github.com/validationcloud/skills to get started

Admin API Keys are team-scoped credentials for managing your Validation Cloud setup programmatically. Provisioning Node API endpoints, reading usage, or wiring Validation Cloud into your own CI/CD.

Availability. Admin API Keys are available on the Scale and Enterprise Node API plans (not Free). Within those teams, only Admins can view this page, create keys, or revoke them. See Team Accounts for how roles differ.

Scopes

Each key is assigned a single scope. Choose the least-privileged one that does the job.

Scope	What the key can do
Read	List endpoints and read usage data
Read & Write	Read operations plus create, update, and delete endpoints

Creating a key

1. On the Admin API Keys page: https://app.validationcloud.io/api-keys, choose a Scope (Read or Read & Write).

2. Give the key a descriptive Name (for example, ci-provisioner).

3. Click Create key, then copy the key and store it somewhere secure.

Keys are shown once and can't be retrieved later. If you lose one, revoke it and create a new one. Treat keys like passwords, store them in a secrets manager and never commit them to source control.

Keys are prefixed with vc_adm_. Pass yours as a bearer token on every request:

curl -s "https://api.validationcloud.io/admin/v1/endpoints" \
  -H "Authorization: ApiKey vc_adm_xxxxxxxxxxxxxxxxxxxx"

Revoking a key

Find the key in the Active Keys list and click Revoke.

Revoking is immediate and permanent. Anything still using the key will start failing authentication. Roll your applications over to a new key before revoking the old one.