{
// the ID of the outcome
"id": 1,
// the URL for fetching/updating the outcome. should be treated as opaque
"url": "/api/v1/outcomes/1",
// the context owning the outcome. may be null for global outcomes
"context_id": 1,
"context_type": "Account",
// title of the outcome
"title": "Outcome title",
// Optional friendly name for reporting
"display_name": "My Favorite Outcome",
// description of the outcome. omitted in the abbreviated form.
"description": "Outcome description",
// A custom GUID for the learning standard.
"vendor_guid": "customid9000",
// maximum points possible. included only if the outcome embeds a rubric
// criterion. omitted in the abbreviated form.
"points_possible": 5,
// points necessary to demonstrate mastery outcomes. included only if the
// outcome embeds a rubric criterion. omitted in the abbreviated form.
"mastery_points": 3,
// the method used to calculate a students score
"calculation_method": "decaying_average",
// this defines the variable value used by the calculation_method. included only
// if calculation_method uses it
"calculation_int": 65,
// possible ratings for this outcome. included only if the outcome embeds a
// rubric criterion. omitted in the abbreviated form.
"ratings": null,
// whether the current user can update the outcome
"can_edit": true,
// whether the outcome can be unlinked
"can_unlink": true,
// whether this outcome has been used to assess a student
"assessed": true,
// whether updates to this outcome will propagate to unassessed rubrics that
// have imported it
"has_updateable_rubrics": true
}
An OutcomeAlignment object looks like:
{
// the id of the aligned learning outcome.
"id": 1,
// the id of the aligned assignment (null for live assessments).
"assignment_id": 2,
// the id of the aligned live assessment (null for assignments).
"assessment_id": 3,
// a string representing the different submission types of an aligned
// assignment.
"submission_types": "online_text_entry,online_url",
// the URL for the aligned assignment.
"url": "/courses/1/assignments/5",
// the title of the aligned assignment.
"title": "Unit 1 test"
}
GET /api/v1/outcomes/:id
Scope:url:GET|/api/v1/outcomes/:id
Returns the details of the outcome with the given id.
Request Parameters:
Parameter
Type
Description
add_defaults
boolean
If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
PUT /api/v1/outcomes/:id
Scope:url:PUT|/api/v1/outcomes/:id
Modify an existing outcome. Fields not provided are left as is; unrecognized fields are ignored.
If any new ratings are provided, the combination of all new ratings provided completely replace any existing embedded rubric criterion; it is not possible to tweak the ratings of the embedded rubric criterion.
A new embedded rubric criterion’s mastery_points default to the maximum points in the highest rating if not specified in the mastery_points parameter. Any new ratings lacking a description are given a default of “No description”. Any new ratings lacking a point value are given a default of 0.
Request Parameters:
Parameter
Type
Description
title
string
The new outcome title.
display_name
string
A friendly name shown in reports for outcomes with cryptic titles, such as common core standards names.
description
string
The new outcome description.
vendor_guid
string
A custom GUID for the learning standard.
mastery_points
integer
The new mastery threshold for the embedded rubric criterion.
ratings[][description]
string
The description of a new rating level for the embedded rubric criterion.
ratings[][points]
integer
The points corresponding to a new rating level for the embedded rubric criterion.
calculation_method
string
The new calculation method. If the Outcomes New Decaying Average Calculation Method FF is ENABLED then “weighted_average” can be used and it is same as previous “decaying_average” and new “decaying_average” will have improved version of calculation.
Allowed values: weighted_average, decaying_average, n_mastery, latest, highest, average
calculation_int
integer
The new calculation int. Only applies if the calculation_method is “decaying_average” or “n_mastery”
add_defaults
boolean
If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
