cURL

curl -X POST https://api.neuraldraft.io/v1/components/register \
  -H "Authorization: Bearer ndsk_live_yourkey" \
  -H "Content-Type: application/json" \
  -d @hero.json

{
  "id": "cmp_2Ngd9KqLmRpW",
  "intent": "marketing_hero",
  "page_slug": "home",
  "html": "<section class=\"hero\" data-nd-component=\"hero\">\n  <h1 data-translate=\"hero.headline\">Find your calm</h1>\n  <p data-translate=\"hero.subhead\">Boutique yoga in Richmond</p>\n  <a href=\"#book\" data-translate=\"hero.cta\">Book a class</a>\n</section>\n",
  "keys_created": [
    "hero.headline",
    "hero.subhead",
    "hero.cta"
  ],
  "created_at": "2026-04-19T10:14:02Z",
  "updated_at": "2026-04-19T10:14:02Z"
}

Components

Register an editable HTML component

Used by AI codegen tools (and the MCP server’s register_component tool) during a build session. The tool says: “I just generated this hero section — register it as editable in the project’s admin.”

Neural Draft parses the HTML, extracts every data-translate="key" attribute, creates the corresponding translation keys, and stores the HTML as a Component. The component then appears in the project admin as editable, and the MCP server can stream changes back via content.changed webhooks.

Costs 0 credits — registration itself is free. Future edits invoked through this component go through the standard content/image endpoints with their normal pricing.

POST

components

cURL

curl -X POST https://api.neuraldraft.io/v1/components/register \
  -H "Authorization: Bearer ndsk_live_yourkey" \
  -H "Content-Type: application/json" \
  -d @hero.json

{
  "id": "cmp_2Ngd9KqLmRpW",
  "intent": "marketing_hero",
  "page_slug": "home",
  "html": "<section class=\"hero\" data-nd-component=\"hero\">\n  <h1 data-translate=\"hero.headline\">Find your calm</h1>\n  <p data-translate=\"hero.subhead\">Boutique yoga in Richmond</p>\n  <a href=\"#book\" data-translate=\"hero.cta\">Book a class</a>\n</section>\n",
  "keys_created": [
    "hero.headline",
    "hero.subhead",
    "hero.cta"
  ],
  "created_at": "2026-04-19T10:14:02Z",
  "updated_at": "2026-04-19T10:14:02Z"
}

Authorizations

Authorization

string

header

required

Project API key. Pass as Authorization: Bearer ndsk_live_.... Manage keys via /projects/me/api-keys. Test-mode keys use the ndsk_test_ prefix.

Body

application/json

html

string

required

HTML chunk to register. Any data-translate="key" attributes are extracted into the project's content keys. Any data-image-key="key" attributes are registered as image slots.

intent

string

Example:

"marketing_hero"

page_slug

string

Example:

"home"

Response

Component registered.

string

required

Example:

"cmp_2Ngd9KqLmRpW"

html

string

required

created_at

string<date-time>

required

updated_at

string<date-time>

required

intent

string | null

Example:

"marketing_hero"

page_slug

string | null

Example:

"home"

keys_created

string[]

Example:

["hero.headline", "hero.subhead", "hero.cta"]

Translate a content key List components