PUT group/…/objective

PUT Create or update a group practice objective for a single group member.

After defining a group practice objective without a review date, a review date per group member can be configured using this endpoint.

Resource URL

https://www.drillster.com/api/2/group/{group_id}/objective/{objective_id}

The group ID is the unique identifier for the group. The objective ID is the unique identifier for the group practice objective.

Parameters

Field Type Description
user
required
String

The user ID of the group member for whom the review date is set.

reviewDate
required
ISO 8601 Date

The review date for the practice objective. The date must be in the future.

Example value: 2015-12-10T02:00:00Z

If a PUT request has no body (i.e. the body is empty), it is still mandatory to include a Content-Length header (i.e. Content-Length: 0). Not all HTTP clients do this automatically. For more information, please see RFC 2616.

Response

An Objective object, with only its id property set.

Example request

PUT https://www.drillster.com/api/2/group/OcPiC-pcH2MaO8pow3TlKB-0wzeHAJzM6vlL1te6wI/objective/FnZYjnYSSmufU-mRfgptyQ
user=oiCRRY67RUuRFv0-h5cZVq
reviewDate=2015-07-03T10:00:00Z

Response

{ }

Error responses

The following error situations are possible:

ID Description
group_not_found Could not retrieve group details.
no_group_access You are not allowed to create or update objectives for this group.
objective_missing No objective was specified
unknown_objective The specified objective is unknown
invalid_objective The specified objective does not belong to the specified group, or it does not allow review dates to be set per group member.
review_date_missing No review date was specified
invalid_review_date The specified date is not a valid ISO 8601 date, or it is in the past
user_id_missing No user ID was specified