# ION Manual

## Docs

- [Administration](https://docs.firstresonance.io/administration/index.md)
- [Integrations](https://docs.firstresonance.io/administration/integrations.md)
- [NetSuite](https://docs.firstresonance.io/administration/integrations/netsuite.md)
- [Organization Settings](https://docs.firstresonance.io/administration/organization-settings.md)
- [Users and Permissions](https://docs.firstresonance.io/administration/users-and-permissions.md)
- [Authentication](https://docs.firstresonance.io/api-reference/authentication.md): How to authenticate against the ION GraphQL API — API keys for machine-to-machine integrations, OAuth 2.0 for user-facing applications, and the error codes you'll hit when something is wrong.
- [Get an aBOM with Full Hierarchy](https://docs.firstresonance.io/api-reference/common-queries/abom-hierarchy.md): Walk an as-built BOM tree from the parent down to all installations.
- [Adjust Inventory](https://docs.firstresonance.io/api-reference/common-queries/adjust-inventory.md): Scrap, transfer, or recount a `PartInventory` row.
- [Compare Two aBOM Versions](https://docs.firstresonance.io/api-reference/common-queries/compare-aboms.md): Pull two as-built BOMs and diff them client-side.
- [Start or Complete a Run](https://docs.firstresonance.io/api-reference/common-queries/complete-run.md): Move a run between lifecycle states.
- [Create an Issue Linked to a Run](https://docs.firstresonance.io/api-reference/common-queries/create-issue.md): Open a quality issue tied to a specific run step.
- [Create a Part](https://docs.firstresonance.io/api-reference/common-queries/create-part.md): Create a new part in the catalog.
- [Create a Purchase Order](https://docs.firstresonance.io/api-reference/common-queries/create-purchase-order.md): Issue a new PO with line items.
- [Create a Run from a Procedure](https://docs.firstresonance.io/api-reference/common-queries/create-run.md): Start a new run by binding a procedure to a part inventory.
- [Get Current User & Org](https://docs.firstresonance.io/api-reference/common-queries/current-user.md): The bare-minimum query to verify your token and discover which tenant you're in.
- [Get a Procedure with All Steps](https://docs.firstresonance.io/api-reference/common-queries/get-procedure.md): Fetch a procedure template plus every step and its fields.
- [Common Queries](https://docs.firstresonance.io/api-reference/common-queries/index.md): Twenty most-common ION GraphQL queries and mutations, organized by use case. Copy, set variables, run.
- [Inventory for a Part by Location](https://docs.firstresonance.io/api-reference/common-queries/inventory-by-location.md): List inventory units of a given part, grouped by physical location.
- [List Open Issues by Disposition](https://docs.firstresonance.io/api-reference/common-queries/list-issues-by-disposition.md): All open issues grouped by disposition type for triage.
- [List Open Runs with Current Step](https://docs.firstresonance.io/api-reference/common-queries/open-runs.md): Get every run that's in progress, with the current step the operator is on.
- [Receive Inventory Against a PO](https://docs.firstresonance.io/api-reference/common-queries/receive-against-po.md): Record receiving of a PO line — creates the corresponding `PartInventory` rows.
- [Close an Issue with a Resolution](https://docs.firstresonance.io/api-reference/common-queries/resolve-issue.md): Move an issue to resolved once reviews are signed off.
- [Run History for a Part](https://docs.firstresonance.io/api-reference/common-queries/run-history-for-part.md): Every run a specific part inventory has gone through, newest first.
- [Search Parts](https://docs.firstresonance.io/api-reference/common-queries/search-parts.md): Find parts by part number or description substring.
- [Serialized Units for a Part](https://docs.firstresonance.io/api-reference/common-queries/serialized-units.md): Get every serialized instance of a part with its current state.
- [Submit a Run Step Result](https://docs.firstresonance.io/api-reference/common-queries/submit-step-result.md): Sign off a step with measurements and optionally pass/fail. Requires the step's etag.
- [Data Model](https://docs.firstresonance.io/api-reference/data-model.md): How ION's core entities relate to each other — parts, inventory, procedures, runs, BOMs, quality — and how they map to terminology in adjacent systems (ERP, MES, PLM).
- [Error Codes](https://docs.firstresonance.io/api-reference/error-codes.md): HTTP status codes and GraphQL error payloads ION returns — what each one means, what causes it, and how to fix it.
- [File Upload](https://docs.firstresonance.io/api-reference/file-upload.md): The three-step flow for uploading files to ION — request a signed upload URL, PUT the file directly to ION's file storage, then register the attachment.
- [Getting Started](https://docs.firstresonance.io/api-reference/getting-started.md): Make your first authenticated GraphQL request to the ION API in under five minutes.
- [GraphQL Field Selection](https://docs.firstresonance.io/api-reference/graphql-field-selection.md): Why your ION queries return sparse data, and how to ask for every field you actually care about.
- [API Reference Overview](https://docs.firstresonance.io/api-reference/overview.md)
- [API Playground](https://docs.firstresonance.io/api-reference/playground.md): Interactive GraphQL playground for the ION API — explore the schema, write queries, and run them against your tenant without leaving the docs.
- [Python Quickstart](https://docs.firstresonance.io/api-reference/python-quickstart.md): A complete, runnable Python integration template for ION — authenticate, list parts, create a run, attach a file. Copy, set two env vars, and run.
- [Sandbox & Dev Environments](https://docs.firstresonance.io/api-reference/sandbox.md): How to request a non-production ION environment for integration development, what's different from prod, and how to promote your integration when you're ready.
- [Webhooks](https://docs.firstresonance.io/api-reference/webhooks.md): Subscribe to ION events and receive HTTP callbacks when records change — no polling required. Covers receiver registration, the (resource, action) subscription model, signature verification, and retry semantics.
- [Analytics and Dashboards](https://docs.firstresonance.io/automate-with-ion/analytics-and-dashboards/index.md)
- [Analytics Troubleshooting](https://docs.firstresonance.io/automate-with-ion/analytics-and-dashboards/troubleshooting.md): When dashboards show empty data, when Autoplan analytics seem stale, and how to troubleshoot the data pipeline behind ION's reports.
- [Autoplan suggested suppliers and procedures](https://docs.firstresonance.io/automate-with-ion/autoplan/autoplan-suggested-suppliers-and-procedures.md)
- [Automate with ION](https://docs.firstresonance.io/automate-with-ion/index.md)
- [ION Actions](https://docs.firstresonance.io/automate-with-ion/ion-actions.md)
- [Notifications](https://docs.firstresonance.io/automate-with-ion/notifications.md)
- [As-built BOM (aBOM)](https://docs.firstresonance.io/build-hardware/bills-of-materials/as-built-bom.md): How the as-built BOM captures what was actually installed at run time — parent/child hierarchy, traceability queries, and the relationship between aBOM and mBOM.
- [Editing Build Requirements](https://docs.firstresonance.io/build-hardware/bills-of-materials/editing-build-requirements.md): Add, remove, and configure build requirements on an aBOM — including quantities, substitutes, reference designators, and Made on Assembly parts.
- [Bills of Materials](https://docs.firstresonance.io/build-hardware/bills-of-materials/index.md): How ION represents what goes into a build — the manufacturing BOM (planned), the as-built BOM (actual), and the build requirements that bridge them at run time.
- [Made on Assembly (MOA)](https://docs.firstresonance.io/build-hardware/bills-of-materials/made-on-assembly.md): Sub-assemblies that get built directly onto the parent rather than as separate runs — when to use MOA, how it changes the workflow, and how it preserves traceability.
- [Manufacturing BOM (mBOM)](https://docs.firstresonance.io/build-hardware/bills-of-materials/manufacturing-bom.md): How the manufacturing BOM defines the planned structure of a build — line items, quantities, alternates, and how runs consume it.
- [Reference Designators](https://docs.firstresonance.io/build-hardware/bills-of-materials/reference-designators.md): Positional identifiers on a build requirement — when to use them, how operators install against specific positions, and why they matter for traceability.
- [Alternates and Substitutes](https://docs.firstresonance.io/build-hardware/bills-of-materials/substitutes.md): How to configure interchangeable parts on the mBOM, and how operators install substitutes during runs without filing deviations.
- [BOM Versions and Change Management](https://docs.firstresonance.io/build-hardware/bills-of-materials/versions.md): How mBOMs are versioned over time, what triggers a new version, and how in-flight runs handle BOM changes.
- [Build Hardware](https://docs.firstresonance.io/build-hardware/index.md)
- [Labels and Scanning](https://docs.firstresonance.io/build-hardware/labels-and-scanning/index.md)
- [Label Printing and Barcodes](https://docs.firstresonance.io/build-hardware/labels-and-scanning/printing.md): Configure printers, select label templates, and print barcode labels for parts, runs, and other entities — across browser, server, and third-party printing modes.
- [Locations and Work Centers](https://docs.firstresonance.io/build-hardware/locations-and-work-centers.md)
- [Attributes and Custom Fields](https://docs.firstresonance.io/build-hardware/parts/attributes-custom-fields.md): The built-in fields on a part record, the optional custom attributes your org can define, and how subtypes group parts together.
- [Creating and Managing Parts](https://docs.firstresonance.io/build-hardware/parts/creating-managing.md): Add a part to the catalog, edit it through its lifecycle, manage revisions, and archive parts that are out of production.
- [Parts](https://docs.firstresonance.io/build-hardware/parts/index.md): How parts work in ION — the catalog entry, its revisions, subtypes, attributes, and how they connect to physical inventory.
- [Inventory and Search](https://docs.firstresonance.io/build-hardware/parts/inventory-search.md): Find parts in the catalog and reach their physical inventory — searching, filtering, and navigating from a part to its on-hand units.
- [Serial and Lot Tracking](https://docs.firstresonance.io/build-hardware/parts/serial-lot-tracking.md): Three tracking types — serial, lot, untracked — and how to pick the right one for each part.
- [Supplier Part Numbers & Purchase Unit Conversions](https://docs.firstresonance.io/build-hardware/parts/supplier-part-numbers-and-purchase-unit-conversions.md)
- [Procedures](https://docs.firstresonance.io/build-hardware/procedures.md)
- [Run Completion and Review](https://docs.firstresonance.io/build-hardware/runs-and-execution/completion-and-review.md): Move a run to complete, run the data-review checklist, close open redlines and issues, and produce the records downstream consumers will need.
- [Runs and Execution](https://docs.firstresonance.io/build-hardware/runs-and-execution/index.md)
- [Run Lifecycle](https://docs.firstresonance.io/build-hardware/runs-and-execution/lifecycle.md): The four states a run moves through, what each one means, and what triggers each transition.
- [Redlines and Deviations](https://docs.firstresonance.io/build-hardware/runs-and-execution/redlines-and-deviations.md): Modify a procedure mid-run when reality diverges from the plan — add steps, edit fields, document deviations — without losing traceability or breaking parallel batched runs.
- [Run Batches](https://docs.firstresonance.io/build-hardware/runs-and-execution/run-batches.md): Group runs that share steps so a single sign-off, redline, or status change propagates to every batched run at once.
- [Starting a Run](https://docs.firstresonance.io/build-hardware/runs-and-execution/starting-a-run.md): Create a run by binding a procedure to a part inventory, configure pre-run options, and assign it to an operator or work center.
- [Step Execution](https://docs.firstresonance.io/build-hardware/runs-and-execution/step-execution.md): How operators run a step — fields, measurements, pass/fail, approval gates, sign-off, and what happens when steps fail.
- [Scheduling and Planning](https://docs.firstresonance.io/build-hardware/scheduling-and-planning.md)
- [Getting Started](https://docs.firstresonance.io/getting-started/index.md)
- [CXOs](https://docs.firstresonance.io/getting-started/role-guides/cxos.md)
- [Design Engineering](https://docs.firstresonance.io/getting-started/role-guides/design-engineering.md)
- [Manufacturing Engineering](https://docs.firstresonance.io/getting-started/role-guides/manufacturing-engineering.md)
- [Production Technicians and Operators](https://docs.firstresonance.io/getting-started/role-guides/production-technicians-and-operators.md)
- [Purchasing and Supply Chain Specialists](https://docs.firstresonance.io/getting-started/role-guides/purchasing-and-supply-chain-specialists.md)
- [Quality Engineering](https://docs.firstresonance.io/getting-started/role-guides/quality-engineering.md)
- [What is ION](https://docs.firstresonance.io/getting-started/what-is-ion.md)
- [Data Import](https://docs.firstresonance.io/manage-supply-chain/data-import.md)
- [Manage Supply Chain](https://docs.firstresonance.io/manage-supply-chain/index.md)
- [Inventory](https://docs.firstresonance.io/manage-supply-chain/inventory.md)
- [Kitting](https://docs.firstresonance.io/manage-supply-chain/kitting.md)
- [Purchasing](https://docs.firstresonance.io/manage-supply-chain/purchasing.md)
- [Receiving](https://docs.firstresonance.io/manage-supply-chain/receiving.md)
- [CAPA Workflows](https://docs.firstresonance.io/track-quality/capa-workflows.md)
- [Containment](https://docs.firstresonance.io/track-quality/containment.md)
- [Track Quality](https://docs.firstresonance.io/track-quality/index.md)
- [Issues and NCRs](https://docs.firstresonance.io/track-quality/issues-and-ncrs/index.md)
- [Issue States, Dispositions, and Resolutions](https://docs.firstresonance.io/track-quality/issues-and-ncrs/states-dispositions-and-resolutions.md): Walk through the issue lifecycle in ION — the four states an issue moves through, the disposition you apply, the approval gates that govern progression, and how reviews close the loop.
- [Quality Reporting](https://docs.firstresonance.io/track-quality/quality-reporting.md)