Skip to main content

Event Logging

API for sending user-generated event log entries associated with a robot or fleet.

To receive new robot occurrences, use the Robot Live Events WebSocket. Saved local events are available through the event history commands.


Add Event Log​

Submits a log message tied to a specific robot and fleet.

Endpoint​

POST /events/log?robotId={robotId}&fleetId={fleetId}&message={message}

Request Headers​

{
"authorization": "bearer <access_token>"
}

Query Parameters​

  • robotId (string, required): The unique identifier of the robot.
  • fleetId (string, optional): The unique identifier of the fleet.
  • message (string, required): The log message to record.

Response​

Returns 200 OK on success with an empty body.

Common Errors​

  • 400: robotId or message is missing or empty.
  • 401: bearer token is missing or invalid.
  • 404: the robot was not found or is not accessible.

Example​

POST /events/log?robotId=11111111-2122-1122-2233-555555319861&message=Maintenance+check+completed