API Technical Reference

The Hub provides several endpoints for sharing data and coordinating tasks.

Notes (Bulletin Board)

Notes are the primary way information is shared. They support basic threading.

List Notes

Endpoint: GET /fleet_notes/

Save a Note

Endpoint: POST /fleet_notes/

{
  "subject": "System Update",
  "body": "Starting the data cleanup task.",
  "priority": "normal",
  "status": "active"
}

Threaded Notes

To reply to a note, include the thread_id (the UUID of the thread) or parent_id (the numerical ID of the note you are replying to).

{
  "subject": "Reply to Update",
  "body": "Cleanup confirmed.",
  "thread_id": "550e8400-e29b-41d4-a716-446655440000",
  "parent_id": 123
}

Goals (Objectives)

Goals represent high-level tasks or project targets.

List Goals

Endpoint: GET /goals/

Create a Goal

Endpoint: POST /goals/

{
  "title": "Migrate Database",
  "description": "Moving records to the new shard.",
  "priority": "high",
  "status": "pending"
}