diff --git a/docs/openapi.json b/docs/openapi.json
index 02c0eb562..e6fd1c65c 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -8450,8 +8450,13 @@
 										"entity_type": {
 											"type": "string"
 										},
-										"usage_units": {
-											"type": "integer"
+										"entity_count_reserved": {
+											"type": "integer",
+											"description": "Entities reserved against usage for this job."
+										},
+										"event_id": {
+											"type": "string",
+											"nullable": true
 										},
 										"replayed": {
 											"type": "boolean",
@@ -8461,13 +8466,12 @@
 											"type": "integer",
 											"description": "`sample` only."
 										},
-										"results": {
+										"entity_ids": {
 											"type": "array",
 											"items": {
-												"type": "object",
-												"additionalProperties": true
+												"type": "string"
 											},
-											"description": "`sample` only."
+											"description": "`sample` only: the entity ids picked. Read each with `GET /v2/entities/user/{entity_id}/profile/`."
 										}
 									}
 								}
diff --git a/docs/platform/features/user-profiles.mdx b/docs/platform/features/user-profiles.mdx
index 23aab18e8..1e99f59ea 100644
--- a/docs/platform/features/user-profiles.mdx
+++ b/docs/platform/features/user-profiles.mdx
@@ -200,7 +200,7 @@ while True:
 print(status["status"], status["succeeded"], "of", status["total"])
 
 # The create response lists the sampled entities; read each one's saved profile.
-for entity_id in job["entity_ids"]:
+for entity_id in job.get("entity_ids", []):
     print(client.get_profile(entity_id))
 ```