provod.ai / docs
API

Management keys

Manage workspace API keys, spending limits and reports.

Last updated on

A management key lets your server manage inference keys and read workspace spending. Use an ordinary API key to call models.

Create a management key

  1. Open Management keys in the cabinet.
  2. Select your personal workspace or organization.
  3. Create a key with a descriptive name.
  4. Save the key secret in your server’s secret store.

Each key is bound to one workspace. Create another key for a different workspace. Do not use scope or X-Org-Id to switch it. Keep the secret out of browser code and repositories.

API reference

EndpointPurpose
GET /v1/keyGet current key
GET /v1/keysList API keys
POST /v1/keysCreate an API key
GET /v1/keys/{hash}Get an API key
PATCH /v1/keys/{hash}Update an API key
DELETE /v1/keys/{hash}Delete an API key
GET /v1/creditsGet top-ups and spending
GET /v1/analytics/metaGet analytics metadata
POST /v1/analytics/queryQuery analytics
GET /v1/activityGet daily activity
GET /v1/generationGeneration metadata and charges

Choose the credential

TaskCredential
POST /v1/chat/completions, /v1/responses, /v1/messagesInference key
GET /v1/balance, GET /v1/usageInference key
Key management and workspace reportsManagement key
GET /v1/key, GET /v1/generationEither kind, within its access boundary

Balance and spending

Permissions and revocation

Create and revoke management keys in the cabinet using a web session. Organization permissions are managementKeys.read, managementKeys.create and managementKeys.revoke; do not send them with Bearer requests. Public methods check the owner’s current access. Revocation is permanent.

On this page