Skip to main content
POST /api/generate/footprint proxies to POST /api/v3/components/generate/footprint. The backend runs the AI agent; the route validates input and maps the response to camelCase. Requires a bearer token and a plan that includes generation.

​
Request

​
Authorization
string
required
Bearer <access_token>
​
description
string
required
5–5000 characters.
​
package_type
string
Optional package hint (e.g. QFN, SOIC).
​
datasheet_url
string
Optional datasheet to ground generation.

​
Response — GenerateFootprintResult

​
success
boolean
​
footprintName
string
From backend name.
​
kicadMod
string | null
Rendered .kicad_mod (backend kicad_mod).
​
padCount
number
From pad_count.
​
pads
Array<{ number, type }>
Derived from trace_json.pads.
​
traceJson
object
The structured payload (used for save).
​
description / source / note
…

​
Example

curl -X POST https://footprints.buildwithtrace.com/api/generate/footprint \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"description":"QFN-16 3x3mm 0.5mm pitch","package_type":"QFN"}'

​
Errors

StatusMeaning
400Description too short/long
401Missing/expired token
402 / 403Plan/quota does not include generation
502 / 500Backend / proxy error
AI-generated footprints are a starting point. Always verify pad geometry, courtyard, and spacing against the datasheet and your fab’s IPC rules before manufacturing.
After generating you can copy or download the .kicad_mod, or save it to the user’s account (pass type: "footprint").