Namemy Keys API

The Keys API from Namemy — 1 operation(s) for keys.

GitHub OpenAPI

Operations 2

GET /keys List API keys #
POST /keys Create API key #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/namemy-app:namemy-app-keys-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

namemy-app-keys-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: namemy.app Keys API
  description: 'The namemy.app API lets AI agents and developers generate brandable names,

    check domain availability, purchase domains, and manage DNS programmatically.


    **Base URL**: `https://namemy.app/api/v1`


    **Authentication**: Bearer token (`Authorization: Bearer nma_live_...`)


    For human users, visit https://namemy.app to manage API keys.'
  version: 1.0.0
  contact:
    name: namemy.app Support
    email: hello@namemy.app
    url: https://namemy.app/agents
servers:
- url: https://namemy.app/api/v1
  description: Production
security:
- bearerAuth: []
tags:
- name: Keys
paths:
  /keys:
    get:
      summary: List API keys
      description: 'Returns all API keys for the authenticated user.

        Requires session-based authentication (not API key).'
      security:
      - sessionAuth: []
      responses:
        '200':
          description: List of API keys
          content:
            application/json:
              schema:
                type: object
                properties:
                  keys:
                    type: array
                    items:
                      $ref: '#/components/schemas/ApiKey'
        '401':
          $ref: '#/components/responses/Unauthorized'
      tags:
      - Keys
      operationId: getKeys
      x-operation-id-source: derived
    post:
      summary: Create API key
      description: 'Create a new API key for agent/programmatic access.

        Requires session-based authentication.'
      security:
      - sessionAuth: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  default: Agent Key
                permissions:
                  type: array
                  items:
                    type: string
                    enum:
                    - names:read
                    - domains:read
                    - domains:write
                    - '*'
                  default:
                  - names:read
                  - domains:read
                  - domains:write
                expiresInDays:
                  type: integer
                  description: Optional expiration in days
      responses:
        '200':
          description: API key created (key shown only once)
          content:
            application/json:
              schema:
                type: object
                properties:
                  key:
                    $ref: '#/components/schemas/ApiKeyWithSecret'
                  warning:
                    type: string
                    example: This key will only be shown once. Copy it now.
        '401':
          $ref: '#/components/responses/Unauthorized'
      tags:
      - Keys
      operationId: postKeys
      x-operation-id-source: derived
components:
  schemas:
    ApiKeyWithSecret:
      allOf:
      - $ref: '#/components/schemas/ApiKey'
      - type: object
        properties:
          key:
            type: string
            description: Full API key (shown only once)
    ApiKey:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        keyPrefix:
          type: string
        permissions:
          type: array
          items:
            type: string
        rateLimit:
          type: integer
        lastUsedAt:
          type: string
          format: date-time
        expiresAt:
          type: string
          format: date-time
        isActive:
          type: boolean
        createdAt:
          type: string
          format: date-time
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: nma_live_
      description: API key prefixed with `nma_live_`
    sessionAuth:
      type: apiKey
      in: cookie
      name: next-auth.session-token
      description: Session cookie from namemy.app dashboard login
x-service-info:
  categories:
  - domains
  docs:
    llms: /llms.txt
    apiReference: /api/openapi.json
    homepage: /
x-pricing:
  provider: namemyapp
  currency: USD
  billing_url: https://namemy.app/pricing
  catalog_url: https://namemy.app/api/openapi.json
  pricing_models_supported:
  - subscription
  - subscription+overage
  - one-time
  - per-year