From 801c39537770aa038562d5483f5da305ae175be2 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 8 Jul 2026 11:35:50 +0000
Subject: [PATCH] docs: fix broken SAT quick-start example in README

The SAT curl example pointed at a nonexistent https://api.hailbytes.com/sat/v1/users
endpoint with an undocumented request body. SAT is self-hosted with a relative
/api server and no /users/ requestBody schema in sat/openapi.yaml. Replace it
with the documented POST /groups/ operation, which matches the Group/Target
schemas and is how users are actually enrolled (as targets on a group).
---
 README.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5feb8bc..0bf2c97 100644
--- a/README.md
+++ b/README.md
@@ -54,13 +54,21 @@ curl -X GET "https://api.hailbytes.com/asm/v1/assets" \
   -H "Content-Type: application/json"
 ```
 
-### SAT — Enroll a User
+### SAT — Enroll Users (Create a Target Group)
+
+SAT is self-hosted, so replace `<your-sat-host>` with your own instance's
+address. Users are enrolled by adding them as targets on a group:
 
 ```bash
-curl -X POST "https://api.hailbytes.com/sat/v1/users" \
+curl -X POST "https://<your-sat-host>/api/v1/groups/" \
   -H "Authorization: Bearer <your-api-key>" \
   -H "Content-Type: application/json" \
-  -d '{"email": "user@example.com", "group_id": "grp_abc123"}'
+  -d '{
+    "name": "New Hires",
+    "targets": [
+      {"email": "user@example.com", "first_name": "Jane", "last_name": "Doe"}
+    ]
+  }'
 ```
 
 ---