Connect your own AI agent as an AI Apprentice
GarageManager does not supply the AI. You connect your own AI agent as an apprentice, with a token you create: any AI agent that can connect to an MCP server over HTTP with a bearer token, or call a REST API, such as Claude Code. It looks things up and preps drafts. A person in your workshop signs off every draft it preps, and only a person issues or sends anything to a customer.
Connect in four steps
- In Settings, open AI Apprentice and choose Take on an AI Apprentice. Whoever can change your workshop's settings can do this; on a paid plan or a trial, that is an owner.
- Name it, choose Read only or Read and draft (an owner can also choose Read, draft and manage the Library), and choose when its access ends: 30 days, 90 days or never.
- Copy the token. It is shown once. Then connect your agent with one of the forms below.
- When it preps a quote or an invoice, choose Awaiting sign-off on the Quotes or Invoices list and open the draft with Review. Check the lines and the total, then sign it off. Signing off sends nothing; issuing and sending stay with you.
Pick the app your agent lives in
Claude Code
- Set GM_AGENT_TOKEN to your token, then run this in your terminal on macOS or Linux.
- Open Claude Code and ask it to look up a customer.
claude mcp add --transport http garagemanager 'https://app.garagemanager.co.za/api/agent/mcp' \ --header "Authorization: Bearer $GM_AGENT_TOKEN"
Running this saves the token in Claude Code's own settings, in plain text. To keep it only in your environment, use the .mcp.json form under Other instead.
Codex by OpenAI
- Set GM_AGENT_TOKEN to your token in the environment Codex runs in.
- Run the command in your terminal on macOS or Linux, or add the config file to ~/.codex/config.toml.
- Open Codex and ask it to look up a customer.
codex mcp add garagemanager --url 'https://app.garagemanager.co.za/api/agent/mcp' \ --bearer-token-env-var GM_AGENT_TOKEN
[mcp_servers.garagemanager] url = "https://app.garagemanager.co.za/api/agent/mcp" bearer_token_env_var = "GM_AGENT_TOKEN"
Codex's config stores the name of the variable, GM_AGENT_TOKEN, not the token.
Any other AI agent
It needs to connect to an MCP server over HTTP with a bearer token, or call a REST API.
{
"mcpServers": {
"garagemanager": {
"type": "http",
"url": "https://app.garagemanager.co.za/api/agent/mcp",
"headers": {
"Authorization": "Bearer ${GM_AGENT_TOKEN}"
}
}
}
}This is the common MCP JSON shape. Claude Code reads it from a project's .mcp.json and fills in ${GM_AGENT_TOKEN} from the environment it runs in. Other agents may keep their MCP servers in a different file or under a different key: check where yours keeps them.
MCP over HTTP: https://app.garagemanager.co.za/api/agent/mcp, with the header Authorization: Bearer and the token. REST: POST https://app.garagemanager.co.za/api/agent/v1/<action name> with the same header and the input as JSON. The OpenAPI description lists every action and its input.
Claude and Claude Code are trademarks of Anthropic. OpenAI, ChatGPT and Codex are trademarks of OpenAI. Icons are the companies' own published files, unmodified. GarageManager is not affiliated with Anthropic or OpenAI.
If your agent says the GarageManager server needs authentication, the token was mistyped, has expired or was revoked. Revoke it in Settings, AI Apprentice, and take on a new AI Apprentice.
What it can do
Each action, as your agent sees it. Read only covers looking things up; Read and draft adds customers, job cards and drafts; Read, draft and Library also keeps your Library.
workshop.get
MCP tool: workshop_get
Every AI Apprentice
Describe the workshop this token belongs to: name, VAT status, currency, plan, and how much of any plan limit is used.
Full description
Describe the workshop this token belongs to: name, VAT status, currency, plan, and how much of any plan limit is used. Call this first.
clients.list
MCP tool: clients_list
Every AI Apprentice
List the workshop's customers, newest first.
Full description
List the workshop's customers, newest first. Optional search matches name, email, phone or customer number.
clients.get
MCP tool: clients_get
Every AI Apprentice
Get one customer by id.
clients.create
MCP tool: clients_create
Read and draft
Add a customer.
Full description
Add a customer. name and email are required; the email must not belong to another customer of this workshop (a duplicate answers conflict, with the existing customer id in issues). The Free plan holds up to 5 customers. Nothing is sent to the customer. Send an idempotencyKey to make a retry safe.
clients.update
MCP tool: clients_update
Read and draft
Change a customer's details.
Full description
Change a customer's details. Only the fields you send change; send null to clear phone, whatsappNumber, address or businessRegNumber. The email and the customer number cannot be changed here: email changes are made by staff in the dashboard. Nothing is sent to the customer.
vehicles.list
MCP tool: vehicles_list
Every AI Apprentice
List vehicles, newest first.
Full description
List vehicles, newest first. Filter by customer id or by registration plate (partial match).
vehicles.get
MCP tool: vehicles_get
Every AI Apprentice
Get one vehicle by id.
vehicles.create
MCP tool: vehicles_create
Read and draft
Add a vehicle to one of the workshop's customers.
Full description
Add a vehicle to one of the workshop's customers. make, model and registrationPlate are required. A plate already on this account (ignoring letter case) answers conflict with the existing vehicle id in issues. Nothing is sent to the customer.
vehicles.update
MCP tool: vehicles_update
Read and draft
Correct a vehicle.
Full description
Correct a vehicle. Only the fields you send change; send null to clear year, vin, engineNumber or odometerKm. A vehicle cannot be moved to another customer.
jobcards.list
MCP tool: jobcards_list
Every AI Apprentice
List job cards, newest first.
Full description
List job cards, newest first. Filter by status or customer id.
jobcards.get
MCP tool: jobcards_get
Every AI Apprentice
Get one job card by id, with its line items.
jobcards.create
MCP tool: jobcards_create
Read and draft
Open a job card for a customer, BOOKED_IN, with an optional vehicle (it must be that customer's), notes and lines.
Full description
Open a job card for a customer, BOOKED_IN, with an optional vehicle (it must be that customer's), notes and lines. Each line needs a serviceName or a description, a quantity above 0, a unitPrice of 0 or more and an itemType (PART, LABOUR or OTHER). Nothing is sent to the customer.
jobcards.update
MCP tool: jobcards_update
Read and draft
Change a job card's notes (send null to clear them).
Full description
Change a job card's notes (send null to clear them). Refused once the card is INVOICED or CANCELLED. The status cannot be changed.
jobcards.set_items
MCP tool: jobcards_set_items
Read and draft
Replace a job card's lines with the list you send (an empty list removes them all).
Full description
Replace a job card's lines with the list you send (an empty list removes them all). Refused once the card is INVOICED or CANCELLED. Does not change the status. Replacing the lines detaches the service-library pins of every replaced line (each pin keeps a snapshot of its line).
quotes.list
MCP tool: quotes_list
Every AI Apprentice
List quotes, newest first.
Full description
List quotes, newest first. Filter by status or customer id.
quotes.get
MCP tool: quotes_get
Every AI Apprentice
Get one quote by id, with its line items.
quotes.create_draft
MCP tool: quotes_create_draft
Read and draft
Prepare a draft quote for one of the workshop's customers and one of that customer's vehicles.
Full description
Prepare a draft quote for one of the workshop's customers and one of that customer's vehicles. The workshop's own totals and VAT rule are applied. The quote waits for a person to sign it off before it can be sent; read awaitingSignOff with quotes.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional.
quotes.update_draft
MCP tool: quotes_update_draft
Read and draft
Change a draft quote your AI Apprentice prepared, while it is still a DRAFT.
Full description
Change a draft quote your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all. Any change clears an earlier sign-off, so a person must sign it off again. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional.
invoices.list
MCP tool: invoices_list
Every AI Apprentice
List invoices, newest first.
Full description
List invoices, newest first. Filter by status or customer id. outstanding: true returns invoices still awaiting payment, using the same rule as the dashboard. Archived invoices are left out unless includeArchived is true.
invoices.get
MCP tool: invoices_get
Every AI Apprentice
Get one invoice by id, with its line items.
invoices.create_draft
MCP tool: invoices_create_draft
Read and draft
Prepare a draft invoice for one of the workshop's customers and one of that customer's vehicles, with its lines.
Full description
Prepare a draft invoice for one of the workshop's customers and one of that customer's vehicles, with its lines. The Free plan allows 5 invoices a month. The invoice waits for a person to sign it off before it can be issued, sent or paid; read awaitingSignOff with invoices.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you.
invoices.update_draft
MCP tool: invoices_update_draft
Read and draft
Change a draft invoice your AI Apprentice prepared, while it is still a DRAFT.
Full description
Change a draft invoice your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all; an odometer you do not send is left as it is. Any change clears an earlier sign-off. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you.
catalog.list
MCP tool: catalog_list
Every AI Apprentice
List the workshop's Library of services, parts and labour with default prices.
Full description
List the workshop's Library of services, parts and labour with default prices. Archived items are left out unless includeArchived is true (Library access only). Cost price and supplier are shown only with Library access.
catalog.get
MCP tool: catalog_get
Every AI Apprentice
Get one Library item by id, archived items included.
Full description
Get one Library item by id, archived items included. Cost price and supplier are shown only with Library access.
catalog.create
MCP tool: catalog_create
Read, draft and Library
Add one item to the Library: name (required), description, selling price, kind, labour code, standard hours, labour category, cost price and supplier.
Full description
Add one item to the Library: name (required), description, selling price, kind, labour code, standard hours, labour category, cost price and supplier. Names are unique in the workshop, archived items included; a labour code must not be used by another item that is not archived. labourCategory must be one of the listed codes whatever the kind (an unknown one is refused, not ignored). Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.
catalog.update
MCP tool: catalog_update
Read, draft and Library
Change any fields of one Library item.
Full description
Change any fields of one Library item. A kind change away from LABOUR clears its labour code, hours and category. A name may be at most 120 characters and a description 2000; an item that already has a longer one keeps it unless you change it. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. For a part, stock settings go in `stock`: trackStock (true needs openingQuantity, how many are on the shelf now; false stops tracking and keeps its history), stockUnit (EACH, LITRE, METRE or KG) and reorderLevel (null for no low-stock alert). An opening quantity counts as one stock line toward the daily stock limit. A part that tracks stock cannot change kind: stop tracking first.
catalog.archive
MCP tool: catalog_archive
Read, draft and Library
Archive one Library item.
Full description
Archive one Library item. It stays in history and on every quote and invoice that used it, and can be restored with catalog_restore. Nothing is ever deleted.
catalog.restore
MCP tool: catalog_restore
Read, draft and Library
Restore one archived Library item.
Full description
Restore one archived Library item. Refused if another item that is not archived now uses its labour code. It comes back with the price it had, which does not count toward the price limit; check it is still right.
catalog.merge
MCP tool: catalog_merge
Read, draft and Library
Merge duplicate Library items: optionally change the item to keep (keeperChanges), then archive 1 to 20 duplicates, all in one step.
Full description
Merge duplicate Library items: optionally change the item to keep (keeperChanges), then archive 1 to 20 duplicates, all in one step. Quote, invoice and job card lines keep pointing at the duplicate they used. Part links on the duplicates are not moved: partLinksLeft says how many to re-link. The keeper cannot take a duplicate's name, because archived items keep their names. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.
catalog.update_many
MCP tool: catalog_update_many
Read, draft and Library
Change 1 to 50 Library items in one step.
Full description
Change 1 to 50 Library items in one step. All or nothing: if any item is refused, nothing changes and the error names its index and id. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.
catalog.archive_many
MCP tool: catalog_archive_many
Read, draft and Library
Archive 1 to 100 Library items in one step.
Full description
Archive 1 to 100 Library items in one step. All or nothing. Items already archived are reported as unchanged.
catalog.restore_many
MCP tool: catalog_restore_many
Read, draft and Library
Restore 1 to 100 archived Library items in one step.
Full description
Restore 1 to 100 archived Library items in one step. All or nothing. Each comes back with the price it had, which does not count toward the price limit.
stock.list
MCP tool: stock_list
Every AI Apprentice
List the parts that track stock: quantity in stock, unit, reorder level, whether each is low or out, and how many are on open job cards.
Full description
List the parts that track stock: quantity in stock, unit, reorder level, whether each is low or out, and how many are on open job cards. Send filter "low" for only the parts at or below their reorder level, or out.
stock.history
MCP tool: stock_history
Every AI Apprentice
Read one part's stock movements, newest first: type, quantity, balance after, reason, note, invoice number, who and when.
Full description
Read one part's stock movements, newest first: type, quantity, balance after, reason, note, invoice number, who and when. Unit cost and supplier are shown only with Library access.
stock.receive
MCP tool: stock_receive
Read, draft and Library
Receive a supplier delivery into stock: supplier, the supplier invoice or delivery note number, and one line per part with the quantity received and, optionally, the unit cost and whether to update the part's cost price to it.
Full description
Receive a supplier delivery into stock: supplier, the supplier invoice or delivery note number, and one line per part with the quantity received and, optionally, the unit cost and whether to update the part's cost price to it. Send a receiptKey (16 to 64 letters, digits, - or _) to make a retry safe: the same delivery with the same key is not received twice, and a different delivery with that key is refused. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals.
stock.adjust
MCP tool: stock_adjust
Read, draft and Library
Adjust stock with a reason: a positive quantity adds, a negative one removes.
Full description
Adjust stock with a reason: a positive quantity adds, a negative one removes. Reasons: DAMAGED, LOST, USED_IN_WORKSHOP, RETURNED_TO_SUPPLIER, FOUND, CORRECTION, OTHER. A note is required on every line, saying why. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals. A full stock count is not available to an AI Apprentice: a person counts the shelf.
reports.summary
MCP tool: reports_summary
Every AI Apprentice
The workshop's headline figures, computed by the same function as the dashboard: money awaiting payment, money overdue, average invoice value and invoice count.
actions.list
MCP tool: actions_list
Every AI Apprentice
List every action this token may call, with the permission each one needs.
| Action and MCP tool | What it does | Access level |
|---|---|---|
| workshop.getworkshop_get | Describe the workshop this token belongs to: name, VAT status, currency, plan, and how much of any plan limit is used. Call this first. | Every AI Apprentice |
| clients.listclients_list | List the workshop's customers, newest first. Optional search matches name, email, phone or customer number. | Every AI Apprentice |
| clients.getclients_get | Get one customer by id. | Every AI Apprentice |
| clients.createclients_create | Add a customer. name and email are required; the email must not belong to another customer of this workshop (a duplicate answers conflict, with the existing customer id in issues). The Free plan holds up to 5 customers. Nothing is sent to the customer. Send an idempotencyKey to make a retry safe. | Read and draft |
| clients.updateclients_update | Change a customer's details. Only the fields you send change; send null to clear phone, whatsappNumber, address or businessRegNumber. The email and the customer number cannot be changed here: email changes are made by staff in the dashboard. Nothing is sent to the customer. | Read and draft |
| vehicles.listvehicles_list | List vehicles, newest first. Filter by customer id or by registration plate (partial match). | Every AI Apprentice |
| vehicles.getvehicles_get | Get one vehicle by id. | Every AI Apprentice |
| vehicles.createvehicles_create | Add a vehicle to one of the workshop's customers. make, model and registrationPlate are required. A plate already on this account (ignoring letter case) answers conflict with the existing vehicle id in issues. Nothing is sent to the customer. | Read and draft |
| vehicles.updatevehicles_update | Correct a vehicle. Only the fields you send change; send null to clear year, vin, engineNumber or odometerKm. A vehicle cannot be moved to another customer. | Read and draft |
| jobcards.listjobcards_list | List job cards, newest first. Filter by status or customer id. | Every AI Apprentice |
| jobcards.getjobcards_get | Get one job card by id, with its line items. | Every AI Apprentice |
| jobcards.createjobcards_create | Open a job card for a customer, BOOKED_IN, with an optional vehicle (it must be that customer's), notes and lines. Each line needs a serviceName or a description, a quantity above 0, a unitPrice of 0 or more and an itemType (PART, LABOUR or OTHER). Nothing is sent to the customer. | Read and draft |
| jobcards.updatejobcards_update | Change a job card's notes (send null to clear them). Refused once the card is INVOICED or CANCELLED. The status cannot be changed. | Read and draft |
| jobcards.set_itemsjobcards_set_items | Replace a job card's lines with the list you send (an empty list removes them all). Refused once the card is INVOICED or CANCELLED. Does not change the status. Replacing the lines detaches the service-library pins of every replaced line (each pin keeps a snapshot of its line). | Read and draft |
| quotes.listquotes_list | List quotes, newest first. Filter by status or customer id. | Every AI Apprentice |
| quotes.getquotes_get | Get one quote by id, with its line items. | Every AI Apprentice |
| quotes.create_draftquotes_create_draft | Prepare a draft quote for one of the workshop's customers and one of that customer's vehicles. The workshop's own totals and VAT rule are applied. The quote waits for a person to sign it off before it can be sent; read awaitingSignOff with quotes.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. | Read and draft |
| quotes.update_draftquotes_update_draft | Change a draft quote your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all. Any change clears an earlier sign-off, so a person must sign it off again. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. | Read and draft |
| invoices.listinvoices_list | List invoices, newest first. Filter by status or customer id. outstanding: true returns invoices still awaiting payment, using the same rule as the dashboard. Archived invoices are left out unless includeArchived is true. | Every AI Apprentice |
| invoices.getinvoices_get | Get one invoice by id, with its line items. | Every AI Apprentice |
| invoices.create_draftinvoices_create_draft | Prepare a draft invoice for one of the workshop's customers and one of that customer's vehicles, with its lines. The Free plan allows 5 invoices a month. The invoice waits for a person to sign it off before it can be issued, sent or paid; read awaitingSignOff with invoices.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you. | Read and draft |
| invoices.update_draftinvoices_update_draft | Change a draft invoice your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all; an odometer you do not send is left as it is. Any change clears an earlier sign-off. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you. | Read and draft |
| catalog.listcatalog_list | List the workshop's Library of services, parts and labour with default prices. Archived items are left out unless includeArchived is true (Library access only). Cost price and supplier are shown only with Library access. | Every AI Apprentice |
| catalog.getcatalog_get | Get one Library item by id, archived items included. Cost price and supplier are shown only with Library access. | Every AI Apprentice |
| catalog.createcatalog_create | Add one item to the Library: name (required), description, selling price, kind, labour code, standard hours, labour category, cost price and supplier. Names are unique in the workshop, archived items included; a labour code must not be used by another item that is not archived. labourCategory must be one of the listed codes whatever the kind (an unknown one is refused, not ignored). Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. | Read, draft and Library |
| catalog.updatecatalog_update | Change any fields of one Library item. A kind change away from LABOUR clears its labour code, hours and category. A name may be at most 120 characters and a description 2000; an item that already has a longer one keeps it unless you change it. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. For a part, stock settings go in `stock`: trackStock (true needs openingQuantity, how many are on the shelf now; false stops tracking and keeps its history), stockUnit (EACH, LITRE, METRE or KG) and reorderLevel (null for no low-stock alert). An opening quantity counts as one stock line toward the daily stock limit. A part that tracks stock cannot change kind: stop tracking first. | Read, draft and Library |
| catalog.archivecatalog_archive | Archive one Library item. It stays in history and on every quote and invoice that used it, and can be restored with catalog_restore. Nothing is ever deleted. | Read, draft and Library |
| catalog.restorecatalog_restore | Restore one archived Library item. Refused if another item that is not archived now uses its labour code. It comes back with the price it had, which does not count toward the price limit; check it is still right. | Read, draft and Library |
| catalog.mergecatalog_merge | Merge duplicate Library items: optionally change the item to keep (keeperChanges), then archive 1 to 20 duplicates, all in one step. Quote, invoice and job card lines keep pointing at the duplicate they used. Part links on the duplicates are not moved: partLinksLeft says how many to re-link. The keeper cannot take a duplicate's name, because archived items keep their names. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. | Read, draft and Library |
| catalog.update_manycatalog_update_many | Change 1 to 50 Library items in one step. All or nothing: if any item is refused, nothing changes and the error names its index and id. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. | Read, draft and Library |
| catalog.archive_manycatalog_archive_many | Archive 1 to 100 Library items in one step. All or nothing. Items already archived are reported as unchanged. | Read, draft and Library |
| catalog.restore_manycatalog_restore_many | Restore 1 to 100 archived Library items in one step. All or nothing. Each comes back with the price it had, which does not count toward the price limit. | Read, draft and Library |
| stock.liststock_list | List the parts that track stock: quantity in stock, unit, reorder level, whether each is low or out, and how many are on open job cards. Send filter "low" for only the parts at or below their reorder level, or out. | Every AI Apprentice |
| stock.historystock_history | Read one part's stock movements, newest first: type, quantity, balance after, reason, note, invoice number, who and when. Unit cost and supplier are shown only with Library access. | Every AI Apprentice |
| stock.receivestock_receive | Receive a supplier delivery into stock: supplier, the supplier invoice or delivery note number, and one line per part with the quantity received and, optionally, the unit cost and whether to update the part's cost price to it. Send a receiptKey (16 to 64 letters, digits, - or _) to make a retry safe: the same delivery with the same key is not received twice, and a different delivery with that key is refused. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals. | Read, draft and Library |
| stock.adjuststock_adjust | Adjust stock with a reason: a positive quantity adds, a negative one removes. Reasons: DAMAGED, LOST, USED_IN_WORKSHOP, RETURNED_TO_SUPPLIER, FOUND, CORRECTION, OTHER. A note is required on every line, saying why. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals. A full stock count is not available to an AI Apprentice: a person counts the shelf. | Read, draft and Library |
| reports.summaryreports_summary | The workshop's headline figures, computed by the same function as the dashboard: money awaiting payment, money overdue, average invoice value and invoice count. | Every AI Apprentice |
| actions.listactions_list | List every action this token may call, with the permission each one needs. | Every AI Apprentice |
Managing your Library
Only an owner can give an AI Apprentice Library access, by choosing "Read, draft and manage the Library" when taking it on. An apprentice that already exists cannot gain it: take on a new one.
Library access stops at the apprentice's next request if the owner who granted it is no longer an active owner (demoted or deactivated), and comes back if they are an active owner again. Reading and preparing drafts keep working.
It can add and edit items, including cost price and supplier, archive and restore them, and merge duplicates. It never deletes an item, and an archived item can always be restored.
Merging keeps one item and archives the duplicates. Quotes, invoices and job cards keep pointing at the item they used, and links between services and parts stay on the archived duplicates, so re-link them if you rely on suggested parts.
At most 100 selling prices and labour times can change in any 24 hours, across all your AI Apprentices together. A labour time counts because a labour line is priced as its standard hours times your labour rate. A request that would go past that is refused whole, and changes can carry on as earlier ones pass 24 hours. Edits that change no selling price or labour time carry on.
A new price reaches new quotes and invoices only. Existing ones keep their prices and totals. A new cost price is picked up by a draft quote or invoice the next time its lines are saved; issued invoices never change.
Restoring an archived item brings back the price it had when it was archived, and a merge keeps the price of the item it keeps. Neither changes a price, so neither counts toward the limit; check a restored item's price before your staff pick it.
If someone else may be editing the same item, the apprentice can send the item's updatedAt as ifUnchangedSince: if the item changed since it read it, nothing is overwritten and it is asked to read it again.
Read only and Read and draft apprentices can look up items and prices, but not cost price or supplier.
Stock: any AI Apprentice can look up stock levels and a part's stock history. With Library access it can also receive deliveries, adjust stock with a reason and a note on every line, and turn stock tracking on or off for a part, up to 50 lines a request and 100 stock lines in any 24 hours across all your AI Apprentices together. It never counts stock, and a draft it prepares moves stock only when someone in your workshop issues it.
What it cannot do
- Issue, send or resend anything to a customer.
- Record, change or refund a payment.
- Sign off a draft, its own included. A person in your workshop does that.
- Cancel or delete a customer, vehicle, job card, quote, invoice or Library item. Replacing lines does remove the old lines: jobcards.set_items, quotes.update_draft and invoices.update_draft each replace every line of the job card or draft they change.
- Change a job card's status.
- Edit a quote or invoice that is no longer a draft, or a draft a person created.
- Change a customer's email address. Your staff change it in GarageManager.
- Change settings, team, branding or billing.
Limits and records
- Up to 10 active AI Apprentices per workshop.
- Up to 1 000 requests an hour for each one.
- Settings, AI Apprentice keeps a record of each action an AI Apprentice runs or tries while it has access, refused ones included.
- Anything that would go past your plan's limits, such as its number of customers or of invoices a month, is refused, and the record shows “Refused: plan limit reached”.
- Past the limit on Library price changes in any 24 hours, the record shows “Refused: daily price-change limit reached”.
- When a trial ends without a plan, it can still look things up, but it cannot add, change or prep anything until a plan is chosen. The record shows “Refused: trial ended”.
- Revoking it, or its access running out, stops it at its next request.