Should I use fleet_ref or fleet_id when querying data?
Use fleet_ref first when querying fleet data in Catena.
For most use cases, use fleet_ref. This is your own identifier and is the most practical way to query data because it maps directly to your internal records.
The fleet_id is Catena's internal UUID and is assigned automatically. It is available in API responses and webhook payloads if you need it, but it is generally not the first choice for queries unless you are working from a context where only the fleet_id is available.