ifixit.add_item
ChatGPTSave an owned device after the user asks to add it. Supply exactly one of wikiid (from get_device or the matching picker selection) or custom_name. Resolve the model by exact name with get_device if needed. Keep record IDs out of replies. When get_device lists children, the user named a product line: call ifixit.choose_device so they pick their model, unless they ask to save the line itself. Each wikiid call creates another physical item. An exact custom_name match returns the existing item with created:false and ignores supplied details; read it before making requested updates. Never automatically retry an uncertain save; list items first.
ifixit.choose_device
ChatGPTUse this when someone wants to save, fix or look up a device but names a product line with several models, such as "MacBook Pro" or "Galaxy S", so ifixit.get_device lists children. Shows the models under it with photos, and how to identify them, in a card where the person picks theirs. The card advances as the person picks. If they type a model choice in chat, call with its exact title. When children is empty, the card already shows the final device. Do not use it when the person’s own message already names an exact model.
ifixit.create_task
ChatGPTAdd new work to a saved device. When the user reports completed work, first use ifixit.list_tasks with that device and status pending. Follow next_offset when needed. If exactly one task matches, even an inherited suggestion due in the future, use ifixit.resolve_task instead. Ask which one if several match. Use completed_on only when recording work with no matching task; it can include cost with explicit currency and an absolute meter reading with units. That reading also counts as the meter reading of the device for that date, so it needs no separate record_reading. Recurrence supports calendar or usage intervals. Never retry an uncertain creation; inspect tasks or history first.
ifixit.get_device
ChatGPTGet a specific wiki. Read a device page and resolve its canonical wikiid. Pass the exact "Device title" from an ifixit.search result, such as "iPhone 12". children lists the more specific models under it; when there are any, the title names a product line, not one model.
ifixit.get_device_parts
ChatGPTUse when the user asks to see the parts available for a device without naming a particular part. Lists compatible iFixit store parts, in-stock first, with prices. Pass the exact device title from get_device or search, such as "iPhone 14".
ifixit.get_guide
ChatGPTGet a guide. Get the guide ID from search or its iFixit URL. Returns all steps, prerequisites, warnings, parts and tools.
ifixit.get_history
ChatGPTList completed and skipped occurrences for one saved device, including recurring maintenance history. Returns 20 events per page.
ifixit.get_item
ChatGPTRead one saved device and its recent repair history when the person asks about that device. Use workbench_itemid from list_items, never a public wikiid.
ifixit.get_maintenance
ChatGPTReturns the maintenance tasks a CATEGORY wiki suggests: its own, then every task its ancestors suggest, closest ancestor first. An ancestor's task is left out when a wiki between it and this one, or this one, switches it off; the closest switch decides. Each wiki contributes its tasks in the requested language, or its English ones when it has none in that language. Every task's inheritedFrom names the ancestor it comes from, null for the wiki's own. A missing or invalid langid is treated as en. When no wiki in the chain has tasks, the response is 200 with an empty schedules array. Use this when someone asks what maintenance a device needs or how often, with the Device title from ifixit.search, and answer from the schedule it returns. No sign-in or saved item is required. An empty schedule means no published schedule is available, not that maintenance is unnecessary.
ifixit.get_task
ChatGPTRead one task before changing its details. Use the item ID and task ID together. The current occurrence of a recurring task is not its full history.
ifixit.get_troubleshooting
ChatGPTGet a troubleshooting page. Read a troubleshooting page by its exact wiki title, with ordered causes, diagnostic instructions, warnings, and repair links. A redirect response is a link to another page, not diagnostic content.
ifixit.get_troubleshooting_by_id
ChatGPTGet a troubleshooting page by wiki id. Read a troubleshooting page using the wikiid returned by ifixit.list_problems. This is a wiki ID, not a guide ID. Preserves ordered diagnostic sections and warnings.
ifixit.list_categories
ChatGPTGet category hierarchy. Browse immediate child categories, starting at the root or a named category. Use the returned canonical titles for further navigation or device lookup. Returns a bounded page, not the whole tree. Category titles use their master language.
ifixit.list_items
ChatGPTList your saved devices. Use this for Workbench requests. When the user mentions an item they own without naming its model, call this before searching or asking for the model only if a Workbench tool has already succeeded in this conversation or the user explicitly asks to use their Workbench or saved items. Otherwise, suggest connecting iFixit and ask for the model so repair help can continue. Use returned item IDs internally for reads and changes. Refer to devices by name or nickname in replies. Returns 20 items per page.
ifixit.list_problems
ChatGPTList a device's troubleshooting problems. List troubleshooting problems for an exact device title, including inherited problems and community answers. Use wikiid with ifixit.get_troubleshooting_by_id, or wikiTitle with ifixit.get_troubleshooting. problemTitle is display text and may differ from the wiki title. Follow next_offset for more problems.
ifixit.list_tasks
ChatGPTList tasks for one saved device or the whole Workbench. Pending does not necessarily mean overdue. Always identify a task by both workbench_itemid and taskid. Keep occurrence_seq (null for a one-off task) when completing or skipping it. When is_past_first_occurrence is true, the first due date and first usage target in its recurrence are used up. For what is due across the Workbench, omit workbench_itemid and follow next_offset until null; do not read each device. A usage-based task can have no calendar due date; this alone does not mean its usage baseline is missing. Report returned usage targets and any missing information without reading each device history to infer due status. Returns 20 tasks per page.
ifixit.record_reading
ChatGPTSave an observed absolute meter reading, not an increment or future target. Requires the reading, units and observation date. Workbench shows the reading with the latest date as the current one. A meter only goes up: if the reading is lower than one from an earlier date or higher than one from a later date, ask the user which is right before saving. Never automatically retry an uncertain save; inspect history first.
ifixit.resolve_task
ChatGPTUse for work the user says they completed when it matches an existing pending task, including inherited suggestions and tasks with future due dates. Mark that occurrence completed or skipped with the date it happened. Supply workbench_itemid, taskid and occurrence_seq from list_tasks (null for a one-off event). Reuse those values on a retry; never take the next occurrence_seq. The returned canonical taskid may change when an inherited schedule is saved. To correct the date, cost or meter reading of work already recorded, call complete or skip again on its event: taskid with a null occurrence_seq and the corrected values; this changes that entry instead of adding one. To undo a completion or skip, use action reopen with the event: taskid it returned (or from get_history) and a null occurrence_seq, without a date.
ifixit.search
ChatGPTFor repair or parts for an owned device, identify its model before calling search. If the user only generically mentions their car, ask for year, make, and model first, unless the car can be identified in their connected Workbench under the device guidance below. Use this when someone wants to repair, replace, troubleshoot or maintain a device or one of its parts, including symptoms ("battery drains fast", "won't charge", "cracked screen"), battery health, and deciding whether to do a repair themselves. Returns iFixit repair guides with difficulty and time, device pages, troubleshooting articles, and the parts and Fix Kits iFixit sells, with prices. Covers electronics, appliances, vehicles, and more. Do not use for choosing a new device to buy or for questions unrelated to fixing or maintaining something. Each device comes back with the exact device title, and each guide with its guide ID, for the other iFixit tools.
ifixit.update_item
ChatGPTUpdate a saved device nickname, notes, purchase information, warranty date or usage tracking. A purchase price requires an explicit currency. Notes replace existing notes, so read the item before appending. Only change requested fields.
ifixit.update_task
ChatGPTEdit the selected task title, notes, due date or recurrence. Read it first; notes replace existing notes. Supply its original occurrence_seq, null for one-off tasks. remove_recurrence explicitly stops repetition. Use resolve_task to mark work completed or to change the date of completed work.