Wazen

API Reference

Complete reference for the Wazen REST API v1.

OpenAPI JSON OpenAPI YAML

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer wz_your_api_key

Create API keys in your Dashboard. Base URL: https://wazen.dev/api/v1

Navigate Endpoints
POST/api/v1/api-keys

Create API key

Generate a new API key for authenticating requests. The raw key is returned only once in the response — store it securely. All subsequent requests use this key in the Authorization header.

Parameters

namerequired
stringin body

A descriptive name for the key (1-255 characters)

Request Body

{
  "name": "production-key"
}

Response

The raw key is included only in the creation response. Store it immediately.

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "production-key",
    "key": "wz_a1b2c3d4e5f6...",
    "createdAt": "2026-03-21T12:00:00Z"
  }
}

Code Examples

curl -X POST https://wazen.dev/api/v1/api-keys \
  -H "Authorization: Bearer wz_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-key"}'