Sync README with current API behavior

mconnell · mconnell · commit 95e09e62afb2 · 2026-03-31T16:19:19.000+01:00
diff --git a/README.md b/README.md
@@ -43,18 +43,12 @@ apps["apple_mail_mac"]["name"]
 apps["apple_mail_mac"]["modes"]
 ```
 
-Create a screenshot submission:
+Create a screenshot submission for all default apps:
 
 ```ruby
-apps = PreflightQA::Apps.list
-
 submission = PreflightQA::Screenshots.create(
   subject: "My Test Email",
   html: "<html><body>Hello world</body></html>",
-  apps: {
-    apple_mail_mac: [:light, :dark],
-    outlook_mac: [:light]
-  },
   webhook_url: "https://example.com/preflight/webhook"
 )
 
@@ -63,6 +57,19 @@ submission.status
 submission.code
 ```
 
+You can also limit the request to specific apps and modes:
+
+```ruby
+submission = PreflightQA::Screenshots.create(
+  subject: "My Test Email",
+  html: "<html><body>Hello world</body></html>",
+  apps: {
+    apple_mail_mac: [:light, :dark],
+    outlook_mac: [:light]
+  }
+)
+```
+
 Find screenshots for a submission:
 
 ```ruby
@@ -75,7 +82,7 @@ end
 
 `PreflightQA::Apps.list` returns the raw `data["apps"]` hash from the API.
 
-`PreflightQA::Screenshots.create` returns `PreflightQA::Submission`.
+`PreflightQA::Screenshots.create` returns `PreflightQA::Submission` with `uuid`, `status`, `code`, and `raw`.
 
 `PreflightQA::Screenshots.find` returns `Array<PreflightQA::Screenshot>`.
 
