Namemy Brand Kits API
The Brand Kits API from Namemy — 3 operation(s) for brand kits.
The Brand Kits API from Namemy — 3 operation(s) for brand kits.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/namemy-app:namemy-app-brand-kits-api"
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.
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: 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