Skip to main content

Pico GraphQL API

Welcome to the Pico Manufacturing Execution System (MES) API. This GraphQL API provides real-time integration capabilities for managing work orders, tracking operations, and monitoring production workflows in your manufacturing environment.

🚀 Quick Start​

The Pico API is a GraphQL interface that provides access to operation configurations and build completion data. Whether you're integrating with an ERP system or automating production workflows, our API provides the real-time capabilities you need.

API Endpoint: Your Pico API endpoint will be provided by your administrator.

🎯 Core Capabilities​

Work Order Management​

Create, update, cancel, and track work orders throughout their lifecycle. Support for both simple process orders and complex product/subassembly waterfalls.

Real-Time Operations Tracking​

Subscribe to live updates for operation completions, material consumption, and production metrics using GraphQL subscriptions.

Operation Queries​

Query operations (products, subassemblies, and processes) to retrieve basic information for mapping to your ERP products and operations.

Production Analytics​

Access detailed operation summaries including cycle times, consumed materials, and operator information for completed operations.

📚 Common Use Cases​

ERP Integration​

The most common integration pattern is a bidirectional work order flow:

  1. Sync Operations - Fetch Pico operations and map them to your ERP system
  2. Create Work Orders - Push work orders to Pico when ready to build
  3. Track Completions - Subscribe to completion events to capture produced products and consumed materials

👉 Work Order Integration Guide - Complete walkthrough with sequence diagram and examples

🔑 Key API Features​

Queries​

  • operations - List and filter products, subassemblies, and processes
  • subOperations - Query parent-child operation relationships
  • operationOrderCompletes - Retrieve completed operation orders

Mutations​

  • operationOrderSave - Create or update work orders for operations
  • operationOrderCancel - Cancel pending work orders

Subscriptions​

  • operationsStream - Stream updates for operations as they are approved through change control
  • subOperationsStream - Stream sub-operation relationship updates
  • operationOrderCompletesStream - Subscribe to work order completions

📖 What You'll Find in These Docs​

  • Type Reference - Complete documentation of all types, queries, mutations, and subscriptions
  • Integration Guides - Step-by-step guides for common integration patterns
  • Examples - Sample queries and mutations to get you started quickly

🛠️ GraphQL Features​

Our API leverages modern GraphQL capabilities:

  • Field Aliasing - Rename fields to match your domain language
  • Subscriptions - Real-time updates via WebSocket connections
  • Filtering - Basic where clauses with equality checks for filtering queries

🔗 Quick Links​

💡 Example Query​

query GetOperations {
  operations(where: { id: { _eq: "prod-123" } }) {
    id
    name
    externalId
    externalRevision
  }
}

📞 Support​

For technical support or questions about the Pico API, please contact your Pico administrator or support team.

Ready to get started? Check out the Common Integration Guide or explore the full API Reference in the sidebar.