Create Api Key

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "workspace_id": "7b9e1f2a-4d3c-4f8a-9a2e-1c2d3e4f5a6b",
    "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "name": "Production API Key",
    "key_type": "live",
    "key_prefix": "pk_live_",
    "key_suffix": "9f8e7d6c",
    "scopes": [
      "workflows:read",
      "workflows:run",
      "voices:read"
    ],
    "active": true,
    "last_used_at": "2024-04-20T14:22:00Z",
    "rate_limit_per_min": 1000,
    "revoked_at": "2024-01-15T09:30:00Z",
    "created_at": "2024-04-15T09:30:00Z",
    "updated_at": "2024-04-20T14:22:00Z",
    "api_key": "pk_live_9f8e7d6c3fa85f64",
    "preview": "pk_live_9f8e7d6c"
  },
  "meta": {
    "request_id": "req_123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2024-04-20T14:22:00Z"
  }
}

Create a live API key and return its plaintext value exactly once.

Authentication

AuthorizationBearer

Clerk JWT token

Headers

X-Workspace-Idstring or nullOptional

Request

This endpoint expects an object.

namestringRequired1-120 characters

scopeslist of enumsOptional

rate_limit_per_mininteger or nullOptional

key_typestringOptionalDefaults to live

Phase 1 supports live bearer keys only; test/public are reserved.

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.onepin.ai/api/v1/api-keys \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Production API Key"
>	}'