The resultSet parameter has four sub-elements:

resultSetId
resultSetTtl
resultSetStatus
numberOfRecords

And I've re-written the description:
"The resultSet parameter is mandatory, and must
include, at minimum, numberOfRecords. If
numberOfRecords is positive then the resultSetId
must also be supplied (accompanied by an optional
ttl)."

Do we need resultSetStatus?  If so what are some
values?

However this question has now occured to me:
suppose the request is a present against an
existing result set, that is the query string is
just the result set id.  As we discussed the
server could choose to create a new (identical)
result set, but also could choose not to. In the
latter case. it would return the same resultSetId,
same value for numberOfRecords, an optional
updated ttl?

Or would it be better to separate out
numberOfRecords and return that only for a new
resultSet?

--Ray