PUT group/…/objective/…

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

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

Resource URL

https://www.drillster.com/api/2.1.1/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 bjective.

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, or the review period end date if the objective has defined a review period. 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 2.1.1 Objective object, with only its id property set.

Example request

PUT https://www.drillster.com/api/2.1/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

Last updated on 2025-04-18