request: schema for full request
response for searches (and errors)
schema: update results (with samples)