Skip to main content

Authentication

Connection Endpoint​

Connect to the websocket server using:

wss://devices.anovaculinary.io

Connection Parameters​

Required query parameters:

  • token: Your personal access token (starts with "anova-")
  • supportedAccessories: The device types you want to control, either APC (Anova Precision Cooker) or APO (Anova Precision Oven), or a comma-separated list containing both

Example connection URL:

wss://devices.anovaculinary.io?token=anova-abcdef123456...&supportedAccessories=APC,APO

Token Format​

  • Start with the prefix "anova-"
  • Each user can have up to 10 PATs

Device Information​

Upon successful connection, you will receive messages containing information about your devices. These messages include the device ID that you'll need for sending commands.

Example:

{
  "command": "EVENT_APO_WIFI_LIST",
  "payload": [
    {
      "cookerId": "[device-id]",
      "name": "Anova Precision Oven",
      "pairedAt": "2025-05-20T20:14:40.118Z",
      "type": "oven_v2"
    }
  ]
}
  • use the cookerId value from these messages

Available Commands​

For Precision Cookers (APC devices)​

See the Precision Cooker Commands for full command examples.

For Precision Ovens (APO devices)​

See the Precision Oven Commands for full command examples.

Device Types​

For Precision Cookers (APC devices)​

Valid values for the payload type parameter include:

  • a3 - First generation WiFi devices
  • a4 - Second generation WiFi devices
  • a5 - Second generation WiFi devices
  • a6 - Third generation WiFi devices
  • a7 - Third generation WiFi devices
  • a8 - Mini WiFi device
  • pro - Pro devices

For Precision Ovens (APO devices)​

Valid values for the payload type parameter include:

  • oven_v1 - First generation WiFi ovens
  • oven_v2 - Second generation WiFi ovens

Rate Limiting​

API calls are rate limited for personal use only and can change. If rate limited, the websocket will disconnect.

Limitations​

PATs can only use the commands listed below

  1. PATs cannot be used to manage other tokens
  2. Maximum of 10 PATs per user
  3. Token names are limited to 32 characters
  4. Connections will timeout after 30 minutes of inactivity