Huecraft API.

Create an account. Body: email, password (8+ characters), full_name. Returns a token and the email.

{"email":"[email protected]","password":"correct horse battery","full_name":"Your Name"}

Sign in. Body: email, password. Returns token, email, name.

{"email":"[email protected]","password":"correct horse battery"}

The signed-in account.

Update your name.

{"full_name":"New Name"}

Change your password. Body: current_password, new_password.

{"current_password":"...","new_password":"..."}

End the session.

Delete your account and its kits.

Start a generation job from a brief. Returns 202 with job_id and a poll URL. business_name is required.

{"business_name":"Kettle & Kiln","business_description":"Handmade stoneware and weekend classes","industry":"Pottery studio","target_audience":"Adults in Portland","personality":["earthy","patient","playful"],"color_preference":"warm browns"}

Job status: status (queued, running, done, failed), progress, stage, kit_id when done; the kit is embedded on completion.

Your kits, newest first (up to 50).

One kit: params and the full kit JSON.

Delete a kit.

The kit's current logo as PNG.

The brand guide PDF, rendered on request if missing.

Research behind the kit as JSON; .md for Markdown; /research/{file} for a captured file.

Ask the kit something. Body: message. Returns the reply; the thread is saved.

{"message":"Why this accent color?"}

The saved conversation.

Multipart upload, field file: an alternative logo image. Returns a score comparison and a brief of the differences.

Which mockup types exist for this kit and which are not yet generated.

Render mockups. Body: types, any of app_icon, sticker, pattern, notepad, business_card, coffee_cup, shopping_bag, packaging_box. Omit for all.

{"types":["business_card","coffee_cup"]}

One rendered mockup.

Your workspaces with role and brand count.

Create a workspace. Body: name.

{"name":"Northwind Legal"}

Members and pending invites.

Invite by email with a role (admin).

{"email":"[email protected]","role":"editor"}

Change a member's role (admin). DELETE removes them.

{"role":"admin"}

Accept an invite link.

Brands in a workspace.

Create a brand (multipart): name, brief fields, colors, fonts and the mark file, or from_name=1 to draft a mark (editor).

A brand with every element's state and files.

Update brand fields (editor).

{"colors":{"primary":"#1F4E79","accent":"#D4A72C"}}

Queue a build; body may list elements to skip. 409 if one is already running (editor).

{"skip":["cover_research"]}

Approve or request changes on an element (admin). Body: element, decision, note.

{"element":"logo_suite","decision":"approved","note":"Ship it"}

Download one built file.