# Polymath API

> HTTP API to control and monitor Polymath-powered autonomous robots: vehicle state, teleoperation, autonomy commands, and the world model (sites, zones, routes).

The Polymath API (Preview) OpenAPI spec is canonical.
Its routes live under `/v1/...` at `https://api.polymathrobotics.dev`.
Every request sends an OAuth 2.0 client-credentials access token in the `Authorization: Bearer <token>` header.

## Specification

- [Polymath API (Preview) OpenAPI spec](https://api-docs.polymathrobotics.com/openapi.json): canonical; redirects to the permalink `/polymath_openapi.json`
- [Legacy Synapse API OpenAPI spec](https://api-docs.polymathrobotics.com/polymath_synapse_v2_openapi.json): routes under `https://polyglot.polymathrobotics.dev/api/synapse/{vehicleId}/...`, being replaced by the Polymath API

## Guides

- [Getting Started](https://api-docs.polymathrobotics.com/docs/guides/getting-started): first request, end to end
- [Authentication](https://api-docs.polymathrobotics.com/docs/guides/authentication): exchange client credentials for a Bearer token
- [Command tracking](https://api-docs.polymathrobotics.com/docs/guides/command-tracking)
- [World model](https://api-docs.polymathrobotics.com/docs/guides/world-model): sites, zones, and routes

## Reference

- [Polymath API (Preview) reference](https://api-docs.polymathrobotics.com/docs/polymath-reference)
- [Legacy Synapse API reference](https://api-docs.polymathrobotics.com/docs/reference)