# AMFG Public API

> REST and MCP access to AMFG Engine entities for external integrations.

## Docs

- [Introduction](/engine-service/public-api/v1/docs): REST and MCP access to AMFG Engine entities for external integrations.
- [Authentication](/engine-service/public-api/v1/docs/authentication): One header, one credential — an Incoming Secret created in the console.
- [Conventions](/engine-service/public-api/v1/docs/conventions): How paths, filters, retrieves, updates and errors behave across every endpoint.
- [Worked examples](/engine-service/public-api/v1/docs/examples): Common flows end to end — reading an order, managing entities, notes, quotes and production.
- [MCP](/engine-service/public-api/v1/docs/mcp): The quote, ticket and part operations as Model Context Protocol tools for AI agents.

## Reference

- [AMFG Public API](/engine-service/public-api/v1/docs/reference)

### Apps

- [Get the app settings](/engine-service/public-api/v1/docs/reference/apps/app-retrieve)

### Blanks

- [Create a blank](/engine-service/public-api/v1/docs/reference/blanks/blank-create)
- [Get a blank](/engine-service/public-api/v1/docs/reference/blanks/blank-retrieve)
- [List blanks](/engine-service/public-api/v1/docs/reference/blanks/blank-list)

### Catalogue Models

- [Create a catalogue model](/engine-service/public-api/v1/docs/reference/catalogue-models/catalogue-model-create)
- [Delete a catalogue model](/engine-service/public-api/v1/docs/reference/catalogue-models/catalogue-model-remove)
- [Get a catalogue model](/engine-service/public-api/v1/docs/reference/catalogue-models/catalogue-model-retrieve)
- [List catalogue models](/engine-service/public-api/v1/docs/reference/catalogue-models/catalogue-model-list)
- [Update a catalogue model](/engine-service/public-api/v1/docs/reference/catalogue-models/catalogue-model-update)

### Catalogues

- [Create a catalogue project](/engine-service/public-api/v1/docs/reference/catalogues/catalogue-create)

### Colours

- [Get a colour](/engine-service/public-api/v1/docs/reference/colours/colour-retrieve)
- [List colours](/engine-service/public-api/v1/docs/reference/colours/colour-list)

### Currencys

- [Get a currency](/engine-service/public-api/v1/docs/reference/currencys/currency-retrieve)
- [List currencys](/engine-service/public-api/v1/docs/reference/currencys/currency-list)

### Customers

- [Create a customer](/engine-service/public-api/v1/docs/reference/customers/customer-create)
- [Get a customer](/engine-service/public-api/v1/docs/reference/customers/customer-retrieve)
- [List customers](/engine-service/public-api/v1/docs/reference/customers/customer-list)
- [Update a customer](/engine-service/public-api/v1/docs/reference/customers/customer-update)

### Items

- [Create an item](/engine-service/public-api/v1/docs/reference/items/item-create)
- [Delete an item (NOT IMPLEMENTED)](/engine-service/public-api/v1/docs/reference/items/item-remove)
- [Get an item](/engine-service/public-api/v1/docs/reference/items/item-retrieve)
- [List items](/engine-service/public-api/v1/docs/reference/items/item-list)
- [Update an item](/engine-service/public-api/v1/docs/reference/items/item-update)

### Machine Groups

- [Create a machine group](/engine-service/public-api/v1/docs/reference/machine-groups/machine-group-create)
- [Delete a machine group](/engine-service/public-api/v1/docs/reference/machine-groups/machine-group-remove)
- [Get a machine group](/engine-service/public-api/v1/docs/reference/machine-groups/machine-group-retrieve)
- [List machine groups](/engine-service/public-api/v1/docs/reference/machine-groups/machine-group-list)
- [Update a machine group](/engine-service/public-api/v1/docs/reference/machine-groups/machine-group-update)

### Machines

- [Assign the reels of a machine](/engine-service/public-api/v1/docs/reference/machines/machine-update-reels)
- [Create a machine](/engine-service/public-api/v1/docs/reference/machines/machine-create)
- [Delete a machine](/engine-service/public-api/v1/docs/reference/machines/machine-remove)
- [Get a machine](/engine-service/public-api/v1/docs/reference/machines/machine-retrieve)
- [List machines](/engine-service/public-api/v1/docs/reference/machines/machine-list)
- [List machines by proximity](/engine-service/public-api/v1/docs/reference/machines/machine-list-by-proximity)
- [Update a machine](/engine-service/public-api/v1/docs/reference/machines/machine-update)

### Material Series

- [Delete a material series](/engine-service/public-api/v1/docs/reference/material-series/material-series-remove)
- [Get a material series](/engine-service/public-api/v1/docs/reference/material-series/material-series-retrieve)
- [List material seriess](/engine-service/public-api/v1/docs/reference/material-series/material-series-list)
- [Update a material series](/engine-service/public-api/v1/docs/reference/material-series/material-series-update)

### Materials

- [Create a material](/engine-service/public-api/v1/docs/reference/materials/material-create)
- [Delete a material](/engine-service/public-api/v1/docs/reference/materials/material-remove)
- [Get a material](/engine-service/public-api/v1/docs/reference/materials/material-retrieve)
- [List materials](/engine-service/public-api/v1/docs/reference/materials/material-list)
- [Update a material](/engine-service/public-api/v1/docs/reference/materials/material-update)

### MCP

- [MCP endpoint (9 tools over JSON-RPC 2.0)](/engine-service/public-api/v1/docs/reference/mcp/mcp)

### Meeting Notes

- [Create a meeting note](/engine-service/public-api/v1/docs/reference/meeting-notes/meeting-note-create)
- [List meeting notes](/engine-service/public-api/v1/docs/reference/meeting-notes/meeting-note-list)

### Model Versions

- [Get a model version](/engine-service/public-api/v1/docs/reference/model-versions/model-version-retrieve)
- [List model versions](/engine-service/public-api/v1/docs/reference/model-versions/model-version-list)
- [Resolve model fields](/engine-service/public-api/v1/docs/reference/model-versions/model-version-fields-resolve)

### Parts (ticket models)

- [Create a ticket model](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-create)
- [Create parts from a catalogue](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-create-from-catalogue)
- [Delete a ticket model](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-remove)
- [Find similar parts](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-similarity)
- [Get a machining strategy](/engine-service/public-api/v1/docs/reference/parts-ticket-models/machining-strategy-retrieve)
- [Get a ticket model](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-retrieve)
- [List ticket models](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-list)
- [Set the machining strategy of a part service](/engine-service/public-api/v1/docs/reference/parts-ticket-models/machining-strategy-update)
- [Update a service job post processing](/engine-service/public-api/v1/docs/reference/parts-ticket-models/service-job-post-processing-update)
- [Update a ticket model](/engine-service/public-api/v1/docs/reference/parts-ticket-models/ticket-model-update)

### PPS

- [Get a PPS record](/engine-service/public-api/v1/docs/reference/pps/pps-retrieve)
- [List PPS records](/engine-service/public-api/v1/docs/reference/pps/pps-list)

### Production Notes

- [Create a production note](/engine-service/public-api/v1/docs/reference/production-notes/production-note-create)
- [List production notes](/engine-service/public-api/v1/docs/reference/production-notes/production-note-list)

### Production Parameter Fields

- [List production parameter fields](/engine-service/public-api/v1/docs/reference/production-parameter-fields/production-parameter-field-list)

### Projects (orders)

- [Create a project](/engine-service/public-api/v1/docs/reference/projects-orders/project-create)
- [Get a project](/engine-service/public-api/v1/docs/reference/projects-orders/project-retrieve-project-id)
- [List projects](/engine-service/public-api/v1/docs/reference/projects-orders/project-list)
- [Look up an order by any identifier](/engine-service/public-api/v1/docs/reference/projects-orders/project-retrieve)
- [Update a project](/engine-service/public-api/v1/docs/reference/projects-orders/project-update)

### Quotation Form Regions

- [Create a quotation form region](/engine-service/public-api/v1/docs/reference/quotation-form-regions/quotation-form-region-create)
- [Delete a quotation form region](/engine-service/public-api/v1/docs/reference/quotation-form-regions/quotation-form-region-remove)
- [Get a quotation form region](/engine-service/public-api/v1/docs/reference/quotation-form-regions/quotation-form-region-retrieve)
- [List quotation form regions](/engine-service/public-api/v1/docs/reference/quotation-form-regions/quotation-form-region-list)
- [Update a quotation form region](/engine-service/public-api/v1/docs/reference/quotation-form-regions/quotation-form-region-update)

### Quotation Forms

- [Get a quotation form](/engine-service/public-api/v1/docs/reference/quotation-forms/quotation-form-retrieve)
- [List quotation forms](/engine-service/public-api/v1/docs/reference/quotation-forms/quotation-form-list)

### Quotes

- [Get a ticket quote](/engine-service/public-api/v1/docs/reference/quotes/ticket-quote-retrieve)
- [List ticket quotes](/engine-service/public-api/v1/docs/reference/quotes/ticket-quote-list)
- [Update a ticket quote](/engine-service/public-api/v1/docs/reference/quotes/ticket-quote-update)

### Reels

- [Create a reel group](/engine-service/public-api/v1/docs/reference/reels/reel-group-create)
- [Create reels in a reel group](/engine-service/public-api/v1/docs/reference/reels/reel-create)
- [Get a reel group](/engine-service/public-api/v1/docs/reference/reels/reel-group-retrieve)
- [List reel groups](/engine-service/public-api/v1/docs/reference/reels/reel-group-list)
- [List reels](/engine-service/public-api/v1/docs/reference/reels/reel-list)
- [List the reels of a reel group](/engine-service/public-api/v1/docs/reference/reels/reel-list-by-location)
- [Update a reel](/engine-service/public-api/v1/docs/reference/reels/reel-update)
- [Update a reel group](/engine-service/public-api/v1/docs/reference/reels/reel-group-update)

### Report Metricss

- [Get a report metrics](/engine-service/public-api/v1/docs/reference/report-metricss/report-metrics-retrieve)

### Service jobs

- [Create a service job](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-create)
- [Delete a service job](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-remove)
- [Get a service job](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-retrieve)
- [Get a service job production](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-production-retrieve)
- [List service job productions](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-production-list)
- [List service jobs](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-list)
- [Service job merge](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-merge)
- [Service job reassign ticket models](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-reassign-ticket-models)
- [Service job timeline start](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-timeline-start)
- [Service job timeline stop](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-timeline-stop)
- [Update a service job](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-update)
- [Update a service job production](/engine-service/public-api/v1/docs/reference/service-jobs/service-job-production-update)

### Services

- [Get a post-processing service and its name](/engine-service/public-api/v1/docs/reference/services/service-retrieve)
- [List post-processing services and their names](/engine-service/public-api/v1/docs/reference/services/service-list)

### Suppliers

- [Get a supplier](/engine-service/public-api/v1/docs/reference/suppliers/supplier-retrieve)
- [List suppliers](/engine-service/public-api/v1/docs/reference/suppliers/supplier-list)

### Technologies

- [Get a technology](/engine-service/public-api/v1/docs/reference/technologies/technology-retrieve)
- [List technologys](/engine-service/public-api/v1/docs/reference/technologies/technology-list)

### Tickets

- [Create a ticket](/engine-service/public-api/v1/docs/reference/tickets/ticket-create)
- [Create and send a quote](/engine-service/public-api/v1/docs/reference/tickets/ticket-quote-create)
- [Look up a ticket by any identifier](/engine-service/public-api/v1/docs/reference/tickets/ticket-retrieve)
- [Send a ticket to production](/engine-service/public-api/v1/docs/reference/tickets/ticket-send-to-production)
- [Update a ticket](/engine-service/public-api/v1/docs/reference/tickets/ticket-update)

### Users

- [Get a user](/engine-service/public-api/v1/docs/reference/users/user-retrieve)
- [List users](/engine-service/public-api/v1/docs/reference/users/user-list)

## Agent resources

- [llms-full.txt](/engine-service/public-api/v1/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](/engine-service/public-api/v1/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](/engine-service/public-api/v1/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at /engine-service/public-api/v1/docs/openapi.json.
- [API catalog](/engine-service/public-api/v1/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](/engine-service/public-api/v1/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.