AMFG Public API

REST surface exposing the AMFG Engine entities to external integrations.

Authentication

One header, one credential — an Incoming Secret created through the console (Settings → API Keys) or POST /api/v1/secret. The value (<secretId>.<random>) is shown once on create and sent on every call:

Authorization: <secret>          # a "Bearer " prefix is also accepted

Every authentication failure returns an identical 401 {"code":401,"message":"Not Authorized"} with no distinction of cause. Secrets created before the Public API shipped cannot authenticate here — regenerate them.

Conventions

• Retrieves are filtered lists: a missing id returns 200 with an empty body, not 404 — check for an id in the response.
• List filters are query parameters; repeatable parameters build arrays (?ids=1&ids=2). Date filters accept a single date or a range (?createdAt[from]=…&createdAt[to]=…).
• Updates are whole-record, not patches — omitting a field the schema requires is a 400 naming it.
• Downstream errors pass through verbatim (status, code, message, type), and x-error-source / x-error-source-request-id headers name the failing service — quote them in support tickets.
• Every authenticated call is metered.

Field-level entity semantics: AMFG Engine API Reference.

MCP

The same operations for quotes, tickets and parts are exposed as 9 MCP tools at POST /mcp (Model Context Protocol, 2026-07-28 spec, same Authorization header) — see the MCP tag.

Apps

• GET
  Get the app settings/app

Blanks

• GET
  List blanks/blank
• POST
  Create a blank/blank
• GET
  Get a blank/blank/{id}

Catalogue Models

• GET
  List catalogue models/catalogue-model
• POST
  Create a catalogue model/catalogue-model
• GET
  Get a catalogue model/catalogue-model/{id}
• PUT
  Update a catalogue model/catalogue-model/{id}
• DELETE
  Delete a catalogue model/catalogue-model/{id}

Catalogues

• POST
  Create a catalogue project/catalogue

Colours

• GET
  List colours/colour
• GET
  Get a colour/colour/{id}

Currencys

• GET
  List currencys/currency
• GET
  Get a currency/currency/{id}

Customers

• GET
  List customers/customer
• POST
  Create a customer/customer
• GET
  Get a customer/customer/{id}
• PUT
  Update a customer/customer/{id}

Items

• GET
  List items/item
• POST
  Create an item/item
• PUT
  Update an item/item/{id}
• DELETE
  Delete an item (NOT IMPLEMENTED)/item/{id}
• GET
  Get an item/item/{partItemId}

MCP

• POST
  MCP endpoint (9 tools over JSON-RPC 2.0)/mcp

Machine Groups

• GET
  List machine groups/machine-group
• POST
  Create a machine group/machine-group
• GET
  Get a machine group/machine-group/{id}
• PUT
  Update a machine group/machine-group/{id}
• DELETE
  Delete a machine group/machine-group/{id}

Machines

• GET
  List machines/machine
• POST
  Create a machine/machine
• GET
  Get a machine/machine/{id}
• PUT
  Update a machine/machine/{id}
• DELETE
  Delete a machine/machine/{id}
• POST
  List machines by proximity/machine/by-proximity
• PUT
  Assign the reels of a machine/machine/{machineId}/reels

Material Series

• GET
  List material seriess/material-series
• GET
  Get a material series/material-series/{id}
• PUT
  Update a material series/material-series/{id}
• DELETE
  Delete a material series/material-series/{id}

Materials

• GET
  List materials/material
• POST
  Create a material/material
• GET
  Get a material/material/{id}
• PUT
  Update a material/material/{id}
• DELETE
  Delete a material/material/{id}

Meeting Notes

• GET
  List meeting notes/meeting-note
• POST
  Create a meeting note/meeting-note

Model Versions

• GET
  List model versions/model-version
• GET
  Get a model version/model-version/{id}
• POST
  Resolve model fields/model-version/{id}/fields-resolve

PPS

• GET
  List PPS records/pps
• GET
  Get a PPS record/pps/{id}

Parts (ticket models)

• GET
  Get a machining strategy/ticket-model/{ticketModelId}/machining-strategy/{serviceId}
• PUT
  Set the machining strategy of a part service/ticket-model/{ticketModelId}/machining-strategy/{serviceId}
• PUT
  Update a service job post processing/ticket-model/{ticketModelId}/post-processing
• GET
  List ticket models/ticket-model
• POST
  Create a ticket model/ticket-model
• GET
  Get a ticket model/ticket-model/{id}
• PUT
  Update a ticket model/ticket-model/{id}
• DELETE
  Delete a ticket model/ticket-model/{id}
• POST
  Create parts from a catalogue/ticket-model/from-catalogue
• POST
  Find similar parts/ticket-model/{id}/similarity

Production Notes

• GET
  List production notes/production-note
• POST
  Create a production note/production-note

Production Parameter Fields

• GET
  List production parameter fields/production-parameter-field

Projects (orders)

• GET
  Look up an order by any identifier/project/lookup
• GET
  List projects/project
• POST
  Create a project/project
• GET
  Get a project/project/{id}
• PUT
  Update a project/project/{id}

Quotation Form Regions

• GET
  List quotation form regions/quotation-form-region
• POST
  Create a quotation form region/quotation-form-region
• GET
  Get a quotation form region/quotation-form-region/{id}
• PUT
  Update a quotation form region/quotation-form-region/{id}
• DELETE
  Delete a quotation form region/quotation-form-region/{id}

Quotation Forms

• GET
  List quotation forms/quotation-form
• GET
  Get a quotation form/quotation-form/{id}

Quotes

• GET
  List ticket quotes/ticket-quote
• GET
  Get a ticket quote/ticket-quote/{id}
• PUT
  Update a ticket quote/ticket-quote/{id}

Reels

• GET
  List reel groups/reel-group
• PUT
  Update a reel group/reel-group
• POST
  Create a reel group/reel-group
• GET
  Get a reel group/reel-group/{id}
• GET
  List reels/reel
• PUT
  Update a reel/reel
• GET
  List the reels of a reel group/inventory-product-location/{inventoryProductLocationId}/reel
• POST
  Create reels in a reel group/inventory-product-location/{inventoryProductLocationId}/reel

Report Metricss

• GET
  Get a report metrics/report-metrics

Service jobs

• GET
  List service jobs/service-job
• POST
  Create a service job/service-job
• GET
  Get a service job/service-job/{id}
• PUT
  Update a service job/service-job/{id}
• DELETE
  Delete a service job/service-job/{id}
• GET
  List service job productions/service-job-production
• GET
  Get a service job production/service-job/{id}/production
• PUT
  Update a service job production/service-job/{id}/production/{ppsId}
• POST
  Service job reassign ticket models/service-job/reassign-ticket-models
• PUT
  Service job merge/service-job/merge
• PUT
  Service job timeline start/service-job/{id}/timeline/start
• PUT
  Service job timeline stop/service-job/{id}/timeline/stop

Services

• GET
  List post-processing services and their names/service
• GET
  Get a post-processing service and its name/service/{id}

Suppliers

• GET
  List suppliers/supplier
• GET
  Get a supplier/supplier/{id}

Technologies

• GET
  List technologys/technology
• GET
  Get a technology/technology/{id}

Tickets

• GET
  Look up a ticket by any identifier/ticket/lookup
• POST
  Create a ticket/ticket
• PUT
  Update a ticket/ticket/{id}
• PUT
  Send a ticket to production/ticket/{id}/send-to-production
• POST
  Create and send a quote/ticket/{ticketId}/quote

Users

• GET
  List users/user
• GET
  Get a user/user/{id}