Get started with the Legion API

The three quickstarts below take you from a username and password to an entity on the map with live video attached. Each page is a few minutes, each ends with a working verification, and each picks up exactly where the previous one stops — or start mid-journey by pasting the IDs you already have.

1. Authenticate — get a Keycloak token, learn its 30-minute lifetime, list your organizations, and meet the X-ORG-ID header that every other call requires.
2. Create your first entity — register a device, read it back, and find it by search.
3. Location and video stream — put the entity on the map, register a stream, publish to it, and watch it.

Every request appears in both curl and Python, with the real request and response bodies. When you outgrow the walkthrough, the API reference documents every endpoint these pages touch, generated from the same specification the API serves.