Create API Key

curl -X POST "https://api.danubeai.com/v1/api-keys" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Key",
    "permissions": {
      "allowed_services": ["service_uuid_1"],
      "allowed_tools": null
    }
  }'

from danube import DanubeClient

client = DanubeClient(api_key="dk_...")
new_key = client.api_keys.create(
    name="Production Key",
    permissions={
        "allowed_services": ["service_uuid_1"],
        "allowed_tools": None,
    }
)
print(f"Key: {new_key.key}")  # Store this securely!

import { DanubeClient } from '@danubeai/sdk';

const client = new DanubeClient({ apiKey: 'dk_...' });
const newKey = await client.apiKeys.create({
  name: 'Production Key',
  permissions: {
    allowedServices: ['service_uuid_1'],
    allowedTools: null,
  }
});
console.log(`Key: ${newKey.key}`);  // Store this securely!

{
  "id": "abc123",
  "key": "dk_new_generated_key_value",
  "key_prefix": "dk_new_g",
  "name": "Production Key",
  "created_at": "2026-02-28T10:00:00Z",
  "last_used": null,
  "permissions": {
    "allowed_services": ["service_uuid_1"],
    "allowed_tools": null
  }
}

POST

api-keys

curl -X POST "https://api.danubeai.com/v1/api-keys" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Key",
    "permissions": {
      "allowed_services": ["service_uuid_1"],
      "allowed_tools": null
    }
  }'

from danube import DanubeClient

client = DanubeClient(api_key="dk_...")
new_key = client.api_keys.create(
    name="Production Key",
    permissions={
        "allowed_services": ["service_uuid_1"],
        "allowed_tools": None,
    }
)
print(f"Key: {new_key.key}")  # Store this securely!

import { DanubeClient } from '@danubeai/sdk';

const client = new DanubeClient({ apiKey: 'dk_...' });
const newKey = await client.apiKeys.create({
  name: 'Production Key',
  permissions: {
    allowedServices: ['service_uuid_1'],
    allowedTools: null,
  }
});
console.log(`Key: ${newKey.key}`);  // Store this securely!

{
  "id": "abc123",
  "key": "dk_new_generated_key_value",
  "key_prefix": "dk_new_g",
  "name": "Production Key",
  "created_at": "2026-02-28T10:00:00Z",
  "last_used": null,
  "permissions": {
    "allowed_services": ["service_uuid_1"],
    "allowed_tools": null
  }
}

Overview

Creates a new API key for the authenticated user. The plaintext key is returned only once in this response — store it securely. Optionally restrict the key to specific services, tools, or spending limits using the permissions field. Auth: Requires JWT token (Authorization: Bearer <token>).

Body Parameters

name

string

required

Display name for the API key (e.g., “Production”, “Agent Key”)

permissions

object

Optional resource-based permissions. If omitted or null, the key has unrestricted access.

Show Permissions object

allowed_services

array

Service UUIDs this key can access. null = all services.

allowed_tools

array

Tool UUIDs this key can access. null = all tools.

max_spend_per_call_cents

integer

Maximum cost per single tool call in cents.

max_spend_per_day_cents

integer

Maximum daily spend for this key in cents.

Response

string

API key UUID

key

string

The plaintext API key (shown once only — store securely)

key_prefix

string

First 8 characters of the key (for identification)

name

string

Display name

created_at

string

ISO 8601 creation timestamp

last_used

string

Last usage timestamp (null on creation)

permissions

object

Resource permissions (null = unrestricted)

Example

curl -X POST "https://api.danubeai.com/v1/api-keys" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Key",
    "permissions": {
      "allowed_services": ["service_uuid_1"],
      "allowed_tools": null
    }
  }'

from danube import DanubeClient

client = DanubeClient(api_key="dk_...")
new_key = client.api_keys.create(
    name="Production Key",
    permissions={
        "allowed_services": ["service_uuid_1"],
        "allowed_tools": None,
    }
)
print(f"Key: {new_key.key}")  # Store this securely!

import { DanubeClient } from '@danubeai/sdk';

const client = new DanubeClient({ apiKey: 'dk_...' });
const newKey = await client.apiKeys.create({
  name: 'Production Key',
  permissions: {
    allowedServices: ['service_uuid_1'],
    allowedTools: null,
  }
});
console.log(`Key: ${newKey.key}`);  // Store this securely!

{
  "id": "abc123",
  "key": "dk_new_generated_key_value",
  "key_prefix": "dk_new_g",
  "name": "Production Key",
  "created_at": "2026-02-28T10:00:00Z",
  "last_used": null,
  "permissions": {
    "allowed_services": ["service_uuid_1"],
    "allowed_tools": null
  }
}

List API Keys Rotate API Key

​Overview

​Body Parameters

​Response

​Example

Overview

Body Parameters

Response

Example