Sha256: 4745c5ec4ae357c75c3604e858b1e8e9dcd7ebc6b644d6b71525abbe5ac54161
Contents?: true
Size: 1.17 KB
Versions: 5
Compression:
Stored size: 1.17 KB
Contents
module Panoptes
class Client
module Subjects
# Get list of subjects
#
# @param subject_set_id [Integer] filter by subject set
# @return list of subjects
def subjects(subject_set_id: nil, workflow_id: nil)
query = {}
query[:subject_set_id] = subject_set_id if subject_set_id
query[:workflow_id] = workflow_id if workflow_id
raise 'Must filter on at least one of subject_set_id, workflow_id' if query.empty?
response = panoptes.paginate("/subjects", query)
response.fetch("subjects")
end
# Retire a subject for a workflow
#
# @todo Add this endpoint to the Apiary docs and add a see-reference here.
# @param workflow_id [Integer] the ID of a workflow
# @param subject_id [Integer] the ID of a subject associated with that workflow (through one of the assigned subject_sets)
# @return nothing
def retire_subject(workflow_id, subject_id, reason: nil)
panoptes.post("/workflows/#{workflow_id}/retired_subjects", {
admin: true,
subject_id: subject_id,
retirement_reason: reason
})
true
end
end
end
end
Version data entries
5 entries across 5 versions & 1 rubygems