Formant

aid: formant
name: Formant
description: Formant is a San Francisco–based robotics and physical-operations cloud platform that lets companies operate
  fleets of robots and advanced connected devices. The Formant software platform implements workflows for remote monitoring,
  intervention requests, data management, teleoperation, tech-support investigations, and business analysis, and exposes an
  extensible cloud infrastructure that can be built upon to create custom robot management experiences. The product surface
  spans an on-robot Formant Agent (ingesting telemetry from ROS / ROS2 / non-ROS sources via configurable adapters), a REST
  Admin API at `api.formant.io/v1/admin`, a Python package (`pip install formant`) that bundles both a Cloud SDK (query and
  ingest data programmatically) and an Agent SDK (post telemetry, handle commands, drive teleoperation from robot-side Python),
  a Data SDK for JavaScript/TypeScript that powers custom views, modules, and embedded experiences, the `fctl` command-line
  tool for SSH / SCP / port-forwarding over Formant's peer-to-peer connection, and Formant Metaphysics — an AI-powered incident-management
  layer that automates alarm triage, predictive maintenance, and SOP-driven investigations across SCADA, Snowflake, Slack,
  and Teams. The API is organized around devices, fleets, streams, views, commands, events, annotations, intervention requests,
  files, key-value storage, roles, users, schedules, analytics, and presence/online monitoring. Formant's GitHub organization
  (FormantIO) publishes the ROS / ROS2 adapter, a Boston Dynamics Spot adapter, an ONVIF camera adapter, a P2P adapter, Cradlepoint
  adapter, the Toolkit meta-repo for building on Formant APIs, the 3D viewer module, custom module boilerplate, Data SDK examples
  for Node.js and React Native, a Homebrew tap for `fctl`, and a public JSON-schema repo for module configuration.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/formant/refs/heads/main/apis.yml
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'
tags:
- Robotics
- Robot Fleet Management
- Teleoperation
- Observability
- Telemetry
- ROS
- ROS2
- Edge Devices
- Physical Operations
- Incident Management
- Industrial AI
- SCADA
- Predictive Maintenance
- Remote Monitoring
- Embedded Devices
kind: contract
position: Consuming
access: 3rd-Party
apis:
- aid: formant:formant-admin-api
  name: Formant Admin API
  description: Formant's primary REST API, served from `https://api.formant.io/v1/admin`. Covers devices, fleets, streams,
    views, teleop views, commands and command templates, schedules, events and custom events, annotations and annotation templates,
    files (multipart begin/complete upload), key-value storage, intervention requests and responses, document sets, insights,
    roles, users, service accounts, tag templates, task summaries and task-summary formats, sharing tokens, analytics (aggregates,
    datapoints, table/columns, task reports), presence and online-device monitoring, usage metrics, and stream current-value
    queries. Endpoints follow a `<resource>controller` naming convention (e.g. `devicecontrollerquery`, `eventcontrollerhistogram`,
    `fleetcontrollergetdevices`). The reference is rendered as ReadMe-hosted OpenAPI pages but Formant does not publish a
    single downloadable OpenAPI spec file.
  humanURL: https://docs.formant.io/reference
  baseURL: https://api.formant.io/v1/admin
  tags:
  - Admin
  - Devices
  - Fleets
  - Streams
  - Events
  - Commands
  - Teleoperation
  properties:
  - type: Documentation
    url: https://docs.formant.io/reference
  - type: Documentation
    url: https://docs.formant.io/reference/devicecontrollerpost
  - type: Documentation
    url: https://docs.formant.io/reference/fleetcontrollerlist
  - type: Documentation
    url: https://docs.formant.io/reference/eventcontrollerquery
  - type: Documentation
    url: https://docs.formant.io/reference/commandcontrollerpost
  - type: Documentation
    url: https://docs.formant.io/reference/viewcontrollerpost
  - type: Documentation
    url: https://docs.formant.io/reference/interventionrequestcontrollerpost
  - type: Documentation
    url: https://docs.formant.io/reference/filecontrollerbeginupload
  - type: Documentation
    url: https://docs.formant.io/reference/analyticscontrollerlistaggregates
  - type: Documentation
    url: https://docs.formant.io/reference/authcontrollerlogin
  - type: Authentication
    url: https://docs.formant.io/reference/authcontrollerlogin
  - type: ServiceAccount
    url: https://docs.formant.io/docs/getting-started-create-a-service-account
- aid: formant:formant-agent-sdk
  name: Formant Agent SDK
  description: Python client embedded in the `formant` PyPI package (`pip install formant`, `from formant.sdk.agent.v1 import
    Client`). Runs on-robot alongside the Formant agent and exposes typed ingestion methods — `post_image`, `post_numeric`,
    `post_numericset`, `post_bitset`, `post_text`, `post_geolocation`, `post_battery`, `post_json` — plus `register_command_request_callback`
    / `send_command_response` for bidirectional command handling and teleoperation hooks. Stream creation is implicit on first
    ingest. Use it when you are not on ROS and want to drive Formant from robot-side Python, or when you want finer-grained
    control than the ROS adapter provides.
  humanURL: https://docs.formant.io/reference/agent-sdk-installation-and-overview
  tags:
  - SDK
  - Agent
  - Python
  - Telemetry
  properties:
  - type: Documentation
    url: https://docs.formant.io/reference/agent-sdk-installation-and-overview
  - type: Documentation
    url: https://docs.formant.io/reference/agent-sdk-reference
  - type: Documentation
    url: https://docs.formant.io/reference/agent-sdk-protos
  - type: SDKs
    url: https://pypi.org/project/formant/
- aid: formant:formant-cloud-sdk
  name: Formant Cloud SDK
  description: Python client embedded in the `formant` PyPI package (`from formant.sdk.cloud.v1 import Client`). Wraps the
    Admin API for programmatic query and ingest of datapoints against your Formant organization without going through the
    agent. Authentication uses `FORMANT_EMAIL` / `FORMANT_PASSWORD` environment variables, or service account credentials
    generated via the web app or `fctl`.
  humanURL: https://docs.formant.io/reference/cloud-sdk-installation-and-overview
  tags:
  - SDK
  - Cloud
  - Python
  - Data Ingestion
  - Data Query
  properties:
  - type: Documentation
    url: https://docs.formant.io/reference/cloud-sdk-installation-and-overview
  - type: Documentation
    url: https://docs.formant.io/reference/cloud-sdk-reference
  - type: SDKs
    url: https://pypi.org/project/formant/
- aid: formant:formant-data-sdk
  name: Formant Data SDK (JavaScript / TypeScript)
  description: Browser- and Node-side JavaScript / TypeScript SDK for building custom modules, custom views, and embedded
    experiences against Formant's real-time and historical data planes. Powers the UI Toolkit, custom 3D viewer layers, real-time
    video modules, and intermodule communication. Reference implementations include FormantMobile (React Native), node-data-sdk
    (Node.js), realtime-sdk-template / -guide / -video-demo, view-embed-react-wrapper, and the broader FormantIO/toolkit meta-repo.
  humanURL: https://docs.formant.io/reference/data-sdk-1
  tags:
  - SDK
  - JavaScript
  - TypeScript
  - Realtime
  - Custom Modules
  properties:
  - type: Documentation
    url: https://docs.formant.io/reference/data-sdk-1
  - type: Documentation
    url: https://docs.formant.io/reference/data-sdk-tour
  - type: Documentation
    url: https://docs.formant.io/reference/ui-toolkit
  - type: Documentation
    url: https://docs.formant.io/reference/web-toolkit-overview
  - type: SourceCode
    url: https://github.com/FormantIO/toolkit
  - type: SourceCode
    url: https://github.com/FormantIO/node-data-sdk
  - type: SourceCode
    url: https://github.com/FormantIO/FormantMobile
common:
- type: Portal
  url: https://formant.io
- type: Documentation
  url: https://docs.formant.io
- type: Documentation
  name: API & SDK Reference
  url: https://docs.formant.io/reference
- type: GettingStarted
  url: https://docs.formant.io/docs/getting-started-overview
- type: Documentation
  name: System Requirements
  url: https://docs.formant.io/docs/system-requirements
- type: Documentation
  name: Formant Agent
  url: https://docs.formant.io/docs/the-formant-agent
- type: Documentation
  name: Adapters Overview
  url: https://docs.formant.io/docs/adapters
- type: Documentation
  name: ROS 2 Adapter
  url: https://docs.formant.io/docs/ros-2-adapter
- type: Documentation
  name: Cloud SDK
  url: https://docs.formant.io/reference/cloud-sdk-installation-and-overview
- type: Documentation
  name: Agent SDK
  url: https://docs.formant.io/reference/agent-sdk-installation-and-overview
- type: Documentation
  name: Data SDK
  url: https://docs.formant.io/reference/data-sdk-1
- type: Documentation
  name: fctl CLI Overview
  url: https://docs.formant.io/reference/fctl-overview-and-installation
- type: Documentation
  name: Teleoperation Getting Started
  url: https://docs.formant.io/docs/getting-started-teleoperation
- type: Documentation
  name: Advanced Teleoperation
  url: https://docs.formant.io/docs/advanced-teleoperation-introduction
- type: Documentation
  name: Fleet Observability
  url: https://docs.formant.io/docs/fleet-observability
- type: Documentation
  name: Incident Management
  url: https://docs.formant.io/docs/incident-management
- type: Documentation
  name: Analytics
  url: https://docs.formant.io/docs/analytics
- type: Documentation
  name: Annotations
  url: https://docs.formant.io/docs/annotations
- type: Documentation
  name: Embedded Views
  url: https://docs.formant.io/docs/embedded-views
- type: Documentation
  name: Integrations Overview
  url: https://docs.formant.io/docs/integrations-overview
- type: Documentation
  name: Configure Google SSO
  url: https://docs.formant.io/docs/configure-google-sso
- type: Documentation
  name: Configure OIDC SSO
  url: https://docs.formant.io/docs/configure-openid-connect-oidc-sso
- type: Documentation
  name: Send Events to PagerDuty
  url: https://docs.formant.io/docs/send-events-to-pagerduty
- type: Documentation
  name: Send Events to Slack
  url: https://docs.formant.io/docs/send-events-to-slack
- type: Documentation
  name: Trigger Webhooks from Events
  url: https://docs.formant.io/docs/trigger-webhooks-from-events
- type: Documentation
  name: SDK Versions, Distributions, Changelogs and Licensing
  url: https://docs.formant.io/docs/sdk-versions-distributions-changelogs-and-licensing
- type: Recipes
  url: https://docs.formant.io/recipes
- type: ChangeLog
  url: https://docs.formant.io/changelog
- type: RoadMap
  url: https://feedback.formant.io/feedback
- type: AIIndex
  name: llms.txt
  url: https://docs.formant.io/llms.txt
- type: Signup
  url: https://app.formant.io/signup
- type: Login
  url: https://app.formant.io
- type: GitHubOrganization
  url: https://github.com/FormantIO
- type: SourceCode
  name: Software releases & development resources
  url: https://github.com/FormantIO/formant
- type: SourceCode
  name: FormantIO/toolkit — open libraries and docs for building on Formant APIs
  url: https://github.com/FormantIO/toolkit
- type: SourceCode
  name: FormantIO/ros2-adapter
  url: https://github.com/FormantIO/ros2-adapter
- type: SourceCode
  name: FormantIO/formant-ros — ROS 1 adapter
  url: https://github.com/FormantIO/formant-ros
- type: SourceCode
  name: FormantIO/adapters — all Formant agent adapters
  url: https://github.com/FormantIO/adapters
- type: SourceCode
  name: FormantIO/formant-spot-adapter — Boston Dynamics Spot adapter
  url: https://github.com/FormantIO/formant-spot-adapter
- type: SourceCode
  name: FormantIO/formant-onvif-adapter — ONVIF camera adapter
  url: https://github.com/FormantIO/formant-onvif-adapter
- type: SourceCode
  name: FormantIO/formant-p2p-adapter
  url: https://github.com/FormantIO/formant-p2p-adapter
- type: SourceCode
  name: FormantIO/Cradlepoint_adapter
  url: https://github.com/FormantIO/Cradlepoint_adapter
- type: SourceCode
  name: FormantIO/ping-adapter
  url: https://github.com/FormantIO/ping-adapter
- type: SourceCode
  name: FormantIO/formant-proxy-adapter
  url: https://github.com/FormantIO/formant-proxy-adapter
- type: SourceCode
  name: FormantIO/formant-speak-robot-adapter
  url: https://github.com/FormantIO/formant-speak-robot-adapter
- type: SourceCode
  name: FormantIO/formant-agent-plugins
  url: https://github.com/FormantIO/formant-agent-plugins
- type: SourceCode
  name: FormantIO/3d-viewer-module
  url: https://github.com/FormantIO/3d-viewer-module
- type: SourceCode
  name: FormantIO/custom-module-boilerplate
  url: https://github.com/FormantIO/custom-module-boilerplate
- type: SourceCode
  name: FormantIO/build-a-module — module-building example
  url: https://github.com/FormantIO/build-a-module
- type: SourceCode
  name: FormantIO/node-data-sdk — Data SDK usage in Node.js
  url: https://github.com/FormantIO/node-data-sdk
- type: SourceCode
  name: FormantIO/FormantMobile — React Native example
  url: https://github.com/FormantIO/FormantMobile
- type: SourceCode
  name: FormantIO/realtime-sdk-template
  url: https://github.com/FormantIO/realtime-sdk-template
- type: SourceCode
  name: FormantIO/realtime-sdk-guide
  url: https://github.com/FormantIO/realtime-sdk-guide
- type: SourceCode
  name: FormantIO/realtime-video-demo
  url: https://github.com/FormantIO/realtime-video-demo
- type: SourceCode
  name: FormantIO/view-embed-react-wrapper
  url: https://github.com/FormantIO/view-embed-react-wrapper
- type: SourceCode
  name: FormantIO/universe-localization-example
  url: https://github.com/FormantIO/universe-localization-example
- type: SourceCode
  name: FormantIO/schemas — JSON schemas used by Formant modules
  url: https://github.com/FormantIO/schemas
- type: SourceCode
  name: FormantIO/homebrew-formant — Homebrew tap for fctl
  url: https://github.com/FormantIO/homebrew-formant
- type: SourceCode
  name: FormantIO/OfflineCommands
  url: https://github.com/FormantIO/OfflineCommands
- type: SourceCode
  name: FormantIO/dataviz-chatgpt — ChatGPT prompts for Formant dataviz
  url: https://github.com/FormantIO/dataviz-chatgpt
- type: SourceCode
  name: FormantIO/formant-institutional-skills — Formant skills for Claude Code
  url: https://github.com/FormantIO/formant-institutional-skills
- type: SourceCode
  name: FormantIO/formant-style-guide — Formant Brand Style Guide 2026
  url: https://github.com/FormantIO/formant-style-guide
- type: SDKs
  name: Python (PyPI)
  url: https://pypi.org/project/formant/
- type: Tools
  name: fctl CLI
  url: https://docs.formant.io/reference/fctl-overview-and-installation
- type: Signup
  url: https://app.formant.io/signup
- type: Pricing
  url: https://formant.io/pricing
- type: Blog
  name: Notes
  url: https://formant.io/notes
- type: Podcast
  url: https://www.youtube.com/@formantinc/podcasts
- type: LinkedIn
  url: https://www.linkedin.com/company/formant
- type: Twitter
  url: https://twitter.com/formantio
- type: YouTube
  url: https://www.youtube.com/@formantinc
- type: Features
  data:
  - REST Admin API at `https://api.formant.io/v1/admin` covering devices, fleets, streams, views, commands, events, annotations,
    files, intervention requests, key-value storage, roles, users, schedules, analytics, presence/online monitoring, and usage
    metrics
  - Formant Agent — on-robot daemon with adapters for ROS, ROS 2, Boston Dynamics Spot, ONVIF cameras, Cradlepoint, ZeroMQ,
    JSON decomposition, and ROS Service
  - Python package (`pip install formant`) bundling both Cloud SDK and Agent SDK clients
  - Cloud SDK — programmatic ingest and query of Formant datapoints from Python (`formant.sdk.cloud.v1.Client`)
  - Agent SDK — on-robot Python client with typed ingestion (`post_numeric`, `post_image`, `post_geolocation`, `post_json`,
    …) and command-handler callbacks
  - Data SDK — JavaScript/TypeScript SDK for custom modules, custom views, embedded views, real-time video, and intermodule
    communication
  - UI Toolkit and Web Toolkit for building custom views and dashboards
  - 3D Scene module with custom-layer extensibility (open-source 3d-viewer-module)
  - Teleoperation — WebRTC-backed real-time control with command buttons, marker arrays, scene module, and multi-image streaming
  - Custom modules via `custom-module-boilerplate` and `build-a-module`
  - Embedded Views with auth-token generation (`generate-auth-token-for-embedded-view`)
  - Intervention Requests — human-in-the-loop intervention workflow with paired request / response resources
  - Annotations — templated, queryable annotations across telemetry streams with spreadsheet inspection
  - Task Summaries and Task Summary Formats for mission and task reporting
  - Insights — stored AI-driven insights and insight results
  - Suggestion API — AI-engine document store, nearest-document search, video frame extraction
  - Custom Events and batch event ingestion
  - Event histograms, severity / device / type aggregations, and event export to Google Sheets
  - File API with begin/complete multipart upload, signed S3 URLs, query and tag updates
  - Key-Value Storage for per-organization persistent state
  - Roles and Service Accounts with administrator, operator, viewer, and device authorization levels
  - SSO via Google and generic OIDC; user invitation, refresh, and external-token login flows
  - Schedules — cron-style scheduling of command templates against fleets
  - Sharing tokens — paginated query of external share links
  - Analytics — aggregate queries, table/column introspection, datapoint query, task reports, and custom SQL
  - Usage Metrics — programmatic consumption reporting
  - Online-device / presence monitoring with `lastSeen` and stream counts (v1 + v2)
  - Tag Templates and bulk tag application across devices and fleets
  - Document Sets — grouped organizational documents for AI / SOP retrieval
  - Sigma analytics embed-URL generation
  - PagerDuty, Slack, Google Sheets, SMS, and arbitrary webhook integrations
  - White-labeled robotics interface and custom-theme support
  - fctl CLI for SSH, SCP, port-forwarding, and remote shell over Formant's peer-to-peer connection
  - Bulk and automated device provisioning with re-provisioning support
  - Configuration templates applied across device groups
  - Audit logs for organizational changes
  - Formant Metaphysics — AI incident-management platform with autonomous alarm triage, predictive maintenance, and SOP-driven
    investigations across SCADA, Snowflake, Slack, and Teams
  - llms.txt index for AI-agent consumption of all docs and OpenAPI endpoints
  sources:
  - https://docs.formant.io/reference
  - https://docs.formant.io/llms.txt
  - https://docs.formant.io
  - https://github.com/FormantIO
  - https://formant.io
  updated: '2026-05-25'
- type: Integrations
  data:
  - ROS 1
  - ROS 2
  - Boston Dynamics Spot
  - ONVIF cameras
  - Cradlepoint cellular routers
  - Jetson / JetBot
  - Universal Robots
  - Foxglove Studio (forked viewer)
  - Webviz (forked viewer)
  - ZeroMQ
  - JSON / file-tail / directory-watch ingestion
  - PagerDuty
  - Slack
  - Microsoft Teams
  - Google Workspace (Sheets, SSO)
  - Generic OIDC SSO
  - AWS S3 export
  - Google Cloud Platform export
  - Snowflake
  - SCADA systems
  - Sigma Computing (embed URL)
  - SMS / event-triggered SMS
  - Generic webhooks
  sources:
  - https://docs.formant.io
  - https://github.com/FormantIO
  updated: '2026-05-25'
- type: Solutions
  data:
  - Fleet observability for service, delivery, and industrial robotics
  - Robot teleoperation and remote intervention
  - Multi-device data ingestion, storage, and replay (ROS bag–style)
  - White-labeled robot management portals for OEMs
  - Incident management and AI alarm triage for physical operations
  - Predictive maintenance and equipment-lifecycle extension
  - Mission planning and task-summary reporting
  - Compliance audit trails for fleet operations
  - Embedded operator views inside third-party applications
  - Field-service investigation workflows with AI-suggested documents
  sources:
  - https://formant.io
  - https://docs.formant.io
  updated: '2026-05-25'
- type: Customers
  data:
  - Tier 1 semiconductor OEMs (aggregated)
  - Hardware OEMs (aggregated)
  - Service robotics fleet operators
  - Industrial automation and manufacturing operators
  sources:
  - https://formant.io
  updated: '2026-05-25'
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com