Create an agent
Creates the agent record and its key. agent_key (and env, with it filled in) is returned only in this response; Observer stores a hash and cannot show it again (rotating the key issues a new one). target (docker, compose, kubernetes, systemd, launchd, binary) adds that ready-to-run install command with the key filled in, and include=install adds all of them; without either the response lists install_targets. delivery=claim returns a single-use console link (claim_url) instead of the key. Names need not be unique, so creating with a name already in use makes a second agent; GET /agents?name= finds existing ones, and connected_ever: false marks one that never ran. Each agent counts toward the organization’s plan limit.
Authorizations
Query Parameters
Body
Response
created
- Option 1
- Option 2
Only with ?target= or ?include=install. Install snippets keyed by target: docker (docker run), compose, kubernetes (Secret + Deployment manifest), systemd (Linux service), launchd (macOS LaunchAgent) and binary (foreground, Linux or macOS). Only the requested target with ?target=, all of them with ?include=install. The systemd, launchd and binary snippets pick the right binary on the host (uname). Without prometheus_url they are for a probes-only agent. The agent key is filled in.

