Namemy Brand Kits API

The Brand Kits API from Namemy — 3 operation(s) for brand kits.

GitHub OpenAPI

Operations 3

POST /brand-kits Generate a complete brand kit #
GET /brand-kits/{id}/exports List available export destinations for a brand kit #
POST /brand-kits/{id}/exports/{format} Run one exporter against a brand kit #

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-brand-kits-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-brand-kits-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: namemy.app Brand Kits 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: Brand Kits
paths:
  /brand-kits:
    post:
      summary: Generate a complete brand kit
      description: 'Gated: Founder/Agency sub OR BRAND_KIT purchase.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                industry:
                  type: string
                description:
                  type: string
                includeVisuals:
                  type: boolean
                  default: true
      responses:
        '200':
          description: Brand kit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandKitOutput'
        '402':
          $ref: '#/components/responses/EntitlementRequired'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-pricing:
        model: included
        description: Brand kit (logo + colors + typography + social headers). One included with every domain bought here, or unlimited with Founder/Agency.
        currency: USD
        billing_url: https://namemy.app/pricing
      tags:
      - Brand Kits
      operationId: postBrandKits
      x-operation-id-source: derived
  /brand-kits/{id}/exports:
    get:
      summary: List available export destinations for a brand kit
      description: 'Returns every registered exporter (DTCG, Tailwind, shadcn, Figma

        Tokens Studio, WordPress theme.json, Webflow CSV, Framer overrides,

        Mailchimp-ready email HTML, Notion, ASE, CMYK+Pantone, and more)

        with the per-format last-run state for this kit.'
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of formats
          content:
            application/json:
              schema:
                type: object
                properties:
                  brandKitId:
                    type: string
                  formats:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        label:
                          type: string
                        category:
                          type: string
                        status:
                          type: string
                          enum:
                          - stable
                          - beta
                          - stub
                        description:
                          type: string
                        destinations:
                          type: array
                          items:
                            type: string
                        latest:
                          type: object
                          nullable: true
                          properties:
                            url:
                              type: string
                            sha256:
                              type: string
                            bytes:
                              type: integer
                            createdAt:
                              type: string
                              format: date-time
      tags:
      - Brand Kits
      operationId: getBrandKitsByIdExports
      x-operation-id-source: derived
  /brand-kits/{id}/exports/{format}:
    post:
      summary: Run one exporter against a brand kit
      description: 'Idempotent — re-running with unchanged inputs returns the same

        sha256-keyed R2 URL without re-uploading. `format` must be one of

        the ids returned by GET `/brand-kits/{id}/exports`.'
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      - in: path
        name: format
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                opts:
                  type: object
                  additionalProperties: true
      responses:
        '200':
          description: Cached export (no upload performed)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandKitExportResult'
        '201':
          description: Newly generated export
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandKitExportResult'
        '402':
          $ref: '#/components/responses/EntitlementRequired'
        '404':
          description: Unknown brand kit or format
        '429':
          $ref: '#/components/responses/RateLimited'
      tags:
      - Brand Kits
      operationId: postBrandKitsByIdExportsByFormat
      x-operation-id-source: derived
components:
  responses:
    EntitlementRequired:
      description: Payment required — endpoint gated by subscription or one-time add-on
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Payment required
              code:
                type: string
                example: entitlement_required
              productType:
                type: string
                example: BRAND_KIT
              productName:
                type: string
                example: Brand Kit
              oneTimePrice:
                type: number
                example: 29.99
              recurring:
                type: string
                enum:
                - one-time
                - monthly
                - yearly
              message:
                type: string
              upgrade:
                type: object
                properties:
                  subscription:
                    type: string
                  oneTimePurchase:
                    type: string
    RateLimited:
      description: Rate limit or daily quota exceeded
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
        X-RateLimit-Remaining:
          schema:
            type: integer
        X-RateLimit-Reset:
          schema:
            type: integer
        X-Daily-Limit:
          schema:
            type: integer
        X-Daily-Remaining:
          schema:
            type: integer
        X-Daily-Reset:
          schema:
            type: integer
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              code:
                type: string
                enum:
                - rate_limit_exceeded
                - daily_quota_exceeded
              tier:
                type: string
                enum:
                - explorer
                - founder
                - agency
              limit:
                type: integer
              upgrade:
                type: string
                example: https://namemy.app/pricing
  schemas:
    BrandKitOutput:
      type: object
      description: Complete brand kit returned by POST /brand-kits
      properties:
        essentials:
          type: object
          properties:
            name:
              type: string
            tagline:
              type: string
            missionStatement:
              type: string
            valueProposition:
              type: string
        audience:
          type: object
          properties:
            primarySegment:
              type: string
            painPoints:
              type: array
              items:
                type: string
            jobsToBeDone:
              type: array
              items:
                type: string
        personality:
          type: object
          properties:
            archetype:
              type: string
            traits:
              type: array
              items:
                type: string
            voiceTone:
              type: string
        visualIdentity:
          type: object
          properties:
            colorPalette:
              type: object
              properties:
                primary:
                  type: string
                  example: '#0F172A'
                secondary:
                  type: string
                accent:
                  type: string
                neutral:
                  type: array
                  items:
                    type: string
            typography:
              type: object
              properties:
                headingFont:
                  type: string
                bodyFont:
                  type: string
                scale:
                  type: string
            logoGuidelines:
              type: object
              properties:
                clearSpace:
                  type: string
                minSize:
                  type: string
        voiceTone:
          type: object
          properties:
            voicePrinciples:
              type: array
              items:
                type: string
            doSay:
              type: array
              items:
                type: string
            dontSay:
              type: array
              items:
                type: string
        imagery:
          type: object
          properties:
            style:
              type: string
            moodKeywords:
              type: array
              items:
                type: string
        applications:
          type: object
          properties:
            website:
              type: string
            socialMedia:
              type: string
            email:
              type: string
        dosDonts:
          type: object
          properties:
            dos:
              type: array
              items:
                type: string
            donts:
              type: array
              items:
                type: string
        visualAssets:
          type: object
          description: Present only when `includeVisuals=true`
          nullable: true
    BrandKitExportResult:
      type: object
      required:
      - format
      - url
      - sha256
      - mime
      - bytes
      - filename
      - fromCache
      description: Single artifact emitted by the composable exporter registry.
      properties:
        format:
          type: string
        url:
          type: string
          format: uri
        sha256:
          type: string
        mime:
          type: string
        bytes:
          type: integer
        filename:
          type: string
        fromCache:
          type: boolean
          description: True when the result was returned from the BrandKitExport ledger without re-uploading.
  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