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

string

required

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

object

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

Show Permissions object

array

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

array

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

integer

Maximum cost per single tool call in cents.

integer

Maximum daily spend for this key in cents.

Response

string

API key UUID

string

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

string

First 8 characters of the key (for identification)

string

Display name

string

ISO 8601 creation timestamp

string

Last usage timestamp (null on creation)

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
  }
}

API Documentation

Tools

Services

Skills

Skill Submissions

Workflows

Agent Sites

Ratings

Wallet

Credentials

Identity

API Keys

Webhooks

Device Auth

Create API Key

Overview

Body Parameters

Response

Example

​Overview

​Body Parameters

​Response

​Example

Overview

Body Parameters

Response

Example