Custom Message Schemas

RIVO allows you to extend the API using JSON Schemas. This enables robots to send custom data without changing the server code.

7.1 Schema Directory

Schemas are stored in the custom_msg/ directory. A manifest file controls which schemas are active.

custom_msg/
├── _manifest.txt          # Active schema list
├── control_input.json     
└── sensor_reading.json    # Your custom schema

7.2 Manifest File

Example _manifest.txt:

# Built-in
control_input.json

# Custom
sensor_reading.json

7.3 Adding a Schema

  1. Create a JSON file (Draft-07 format).
  2. Add the filename to _manifest.txt.
  3. Restart RIVO Server.

The new endpoint will be available at /api/v1/robots/{id}/<schema_id>.