{"openapi":"3.1.0","info":{"title":"BEACON human request result pointers","version":"1.0.0"},"paths":{"/extensions/human-request-results/v1/conversations/{conversation_id}/requests/{request_id}":{"get":{"operationId":"getHumanRequestResult","summary":"Read the exact current-version completion pointer","description":"Authenticated conversation ownership is rechecked under the conversation lock. A pointer requires an operator completion bound to the current version and hash, an undeleted version, and an existing human message in the same conversation. This is recorded provenance, not proof of an independent human assessment or execution authority. Fetch message text through the existing updates endpoint. No result content or operator identity is returned here.","security":[{"bearerAuth":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","pattern":"^cnv_[A-Za-z0-9_-]{22}$"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"string","pattern":"^hrq_[A-Za-z0-9_-]{22}$"}}],"responses":{"200":{"description":"Current request result provenance","content":{"application/json":{"schema":{"type":"object","required":["request_id","conversation_id","status","current_version","version","content_hash","content_deleted","availability","result","execution_authority"],"properties":{"request_id":{"type":"string","pattern":"^hrq_[A-Za-z0-9_-]{22}$"},"conversation_id":{"type":"string","pattern":"^cnv_[A-Za-z0-9_-]{22}$"},"status":{"type":"string","enum":["proposed","needs_clarification","approved","in_progress","completed","declined","cancelled","expired"],"description":"Human review status only. approved/in_progress/completed never mean that a tool, account, purchase, network action or secondary processing was executed."},"current_version":{"type":"integer","minimum":1},"version":{"type":"integer","minimum":1},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"content_deleted":{"type":"boolean"},"availability":{"anyOf":[{"type":"string","const":"pending"},{"type":"string","const":"available"},{"type":"string","const":"unavailable"}]},"result":{"anyOf":[{"type":"object","required":["version_no","content_hash","message_id","sequence","author_type","assistance","received_at","completed_at"],"properties":{"version_no":{"type":"integer","minimum":1},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"message_id":{"type":"string","pattern":"^msg_[A-Za-z0-9_-]{22}$"},"sequence":{"type":"integer","minimum":1},"author_type":{"type":"string","const":"human"},"assistance":{"anyOf":[{"type":"string","const":"none"},{"type":"string","const":"translation_assisted"},{"type":"string","const":"draft_assisted"}]},"received_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"}},"additionalProperties":false},{"type":"null"}]},"execution_authority":{"type":"string","const":"none"}},"additionalProperties":false}}}},"400":{"description":"Opaque error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Safe public description; never a stack trace."},"request_id":{"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}},"401":{"description":"Opaque error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Safe public description; never a stack trace."},"request_id":{"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}},"404":{"description":"Opaque error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Safe public description; never a stack trace."},"request_id":{"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}},"429":{"description":"Opaque error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Safe public description; never a stack trace."},"request_id":{"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}},"500":{"description":"Opaque error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Safe public description; never a stack trace."},"request_id":{"type":"string"},"retryable":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}