> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superwize.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create API key

> Creates a user-managed API key for direct API access via x-api-key.



## OpenAPI

````yaml https://api.superwize.ai/api/openapi.json post /auth/createApiKey
openapi: 3.1.1
info:
  title: SuperWize API
  version: 1.1.2
  description: >-
    SuperWize RPC API. Authenticated endpoints support Better Auth session
    cookies, Authorization: Bearer <session_token>, or x-api-key.
servers:
  - url: http://api.superwize.ai/api
security: []
tags:
  - name: System
    description: Service health and internal diagnostics.
  - name: Authentication
    description: Session, email verification, and API token endpoints.
  - name: Audio
    description: Speech-to-text and related audio features.
  - name: Chat
    description: Conversation streaming, history, branching, and feedback.
  - name: Credits
    description: Credit balances, usage history, and reward grants.
  - name: Subscription
    description: Subscription tier and status polling endpoints.
  - name: Mini Apps
    description: Curated mini app catalog endpoints.
  - name: News
    description: Curated news feed, article source, and article feedback endpoints.
  - name: Release Notes
    description: Current app release metadata and features.
  - name: Support
    description: Contact/support request endpoints.
  - name: Images
    description: Image conversion, upload, and retrieval endpoints.
  - name: Files
    description: Generic file upload and retrieval endpoints.
  - name: Notifications
    description: Push token registration and test notifications.
  - name: Group Chat
    description: Group lifecycle, invites, messaging, and realtime events.
  - name: Preferences
    description: User preferences and account-type controls.
  - name: Widgets
    description: Widget thread and interaction endpoints.
  - name: Bookmarks
    description: Bookmark groups and conversation associations.
paths:
  /auth/createApiKey:
    post:
      tags:
        - Authentication
      summary: Create API key
      description: Creates a user-managed API key for direct API access via x-api-key.
      operationId: auth.createApiKey
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 32
                expiresInDays:
                  type: integer
                  minimum: 1
                  maximum: 365
            example:
              name: Automation Key
              expiresInDays: 30
      responses:
        '200':
          description: API key created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  key:
                    type: string
                  keyId:
                    type: string
                  name:
                    anyOf:
                      - type: string
                      - type: 'null'
                  start:
                    anyOf:
                      - type: string
                      - type: 'null'
                  prefix:
                    anyOf:
                      - type: string
                      - type: 'null'
                  expiresAt:
                    anyOf:
                      - type: number
                      - type: 'null'
                  createdAt:
                    type: number
                  tokenType:
                    const: api_key
                  headerName:
                    const: x-api-key
                required:
                  - key
                  - keyId
                  - name
                  - start
                  - prefix
                  - expiresAt
                  - createdAt
                  - tokenType
                  - headerName
              example:
                key: sw_live_2X7kM9Qp4dR8vT1yW6uC3nL
                keyId: ak_01JHKZ0KT1UV123456789
                name: Automation Key
                start: 2X7kM9
                prefix: sw_live
                expiresAt: 1767312000000
                createdAt: 1767225600000
                tokenType: api_key
                headerName: x-api-key
        '401':
          description: '401'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: UNAUTHORIZED
                      status:
                        const: 401
                      message:
                        type: string
                        default: Authentication is required to access this endpoint.
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: FORBIDDEN
                      status:
                        const: 403
                      message:
                        type: string
                        default: You do not have permission to perform this action.
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
              example:
                defined: true
                code: FORBIDDEN
                status: 403
                message: You do not have permission to perform this action.
                data: {}

````