Skip to main content

Update Line Item by ID

The LTI protocol allows you to update(replace) a specific grade line in the LMS grade book through the Assignment and Grades - Line Items service. In the context of LTI, these grade lines are called line items. LTIAAS gives you access to this service through the /api/lineitems API endpoint.

Please check our Manipulating grade lines guide and its Updating a grade line by its ID section to learn more about using this endpoint.

API Authentication MethodSupported
LTIK-AUTH-V2
SERVICE-AUTH-V1
Path Parameters
    lineItemID uri required

    The URL encoded line item ID.

Request Body
    label string required

    The label is a short string with a human readable text for the line item. It MUST be specified and not blank when posted by the tool. A platform must always include the label.

    scoreMaximum number required

    Possible values: > 0

    The maximum score for this line item. Maximum score MUST be a numeric non-null value, strictly greater than 0.

    resourceLinkId string

    A line item MAY be attached to a resource link by including a 'resourceLinkId' in the payload. The resource link MUST exist in the context where the line item is created, and MUST be a link owned by the same tool. If not, the line item creation MUST fail with a response code of Not Found 404.

    The platform MAY remove the line items attached to a resource link if the resource link itself is removed.

    resourceId string

    A tool MAY identify to which of its resources the line item is attached to by including a non blank value for resourceId in the payload. This value is a string. For example, resourceId can be 'quiz-231' or any other resource identifier uniquely identifying a resource in a given context.

    Multiple line items can share the same resourceId within a given context. resourceId must be preserved when a context is copied if the line items are included in the copy.

    If no resourceId is defined for a lineitem, the platform may omit this attribute, or include it with a blank or null value.

    tag string

    A tool MAY further qualify a line item by setting a value to tag. The attribute is a string. For example, one assignment resource may have 2 line items, one with tag as 'grade' and the other tagged as 'originality'.

    Multiple line items can share the same tag within a given context. tag must be preserved when a context is copied if the line items are included in the copy.

    If no tag is defined for a lineitem, the platform may omit this attribute, or include it with a blank or null value.

    startDateTime date-time

    A tool MAY specify the initial start time submissions for this line item can be made by learners. The initial value may subsequently be changed within the platform.

    ISO 8601 Date and time when the line item can start receiving submissions.

    endDateTime date-time

    A tool MAY specify the initial end time submissions for this line item can be made by learners. The initial value may subsequently be changed within the platform.

    ISO 8601 Date and time when the line item stops receiving submissions.

    gradesReleased boolean

    The tool specifies this optional property when it wishes the grades to be released. It is up to the LMS to decide how to handle this and every LMSes behavior may be different.

Responses


Schema
    id uri required

    URL uniquely identifying the result record.

    label string required

    The label is a short string with a human readable text for the line item. It MUST be specified and not blank when posted by the tool. A platform must always include the label.

    scoreMaximum number required

    Possible values: > 0

    The maximum score for this line item. Maximum score MUST be a numeric non-null value, strictly greater than 0.

    resourceLinkId string

    A line item MAY be attached to a resource link by including a 'resourceLinkId' in the payload. The resource link MUST exist in the context where the line item is created, and MUST be a link owned by the same tool. If not, the line item creation MUST fail with a response code of Not Found 404.

    The platform MAY remove the line items attached to a resource link if the resource link itself is removed.

    resourceId string

    A tool MAY identify to which of its resources the line item is attached to by including a non blank value for resourceId in the payload. This value is a string. For example, resourceId can be 'quiz-231' or any other resource identifier uniquely identifying a resource in a given context.

    Multiple line items can share the same resourceId within a given context. resourceId must be preserved when a context is copied if the line items are included in the copy.

    If no resourceId is defined for a lineitem, the platform may omit this attribute, or include it with a blank or null value.

    tag string

    A tool MAY further qualify a line item by setting a value to tag. The attribute is a string. For example, one assignment resource may have 2 line items, one with tag as 'grade' and the other tagged as 'originality'.

    Multiple line items can share the same tag within a given context. tag must be preserved when a context is copied if the line items are included in the copy.

    If no tag is defined for a lineitem, the platform may omit this attribute, or include it with a blank or null value.

    startDateTime date-time

    A tool MAY specify the initial start time submissions for this line item can be made by learners. The initial value may subsequently be changed within the platform.

    ISO 8601 Date and time when the line item can start receiving submission.

    endDateTime date-time

    A tool MAY specify the initial end time submissions for this line item can be made by learners. The initial value may subsequently be changed within the platform.

    ISO 8601 Date and time when the line item stops receiving submissions.

    gradesReleased boolean

    The tool specifies this optional property when it wishes the grades to be released. It is up to the LMS to decide how to handle this and every LMSes behavior may be different.

Loading...

All trademarks, logos, and service marks displayed on this website are the property of their respective owners. LTIAAS is a trademark of GatherAct, LLC, doing business as LTIAAS. Learning Tools Interoperability (LTI)® is a trademark of 1EdTech Consortium, Inc. LTIAAS is not affiliated with, endorsed or sponsored by 1EdTech Consortium, Inc. or by any other owners of third-party trademarks used on this website. LTIAAS is not responsible for the content, quality, or accuracy of any websites linked to or from this website that are not owned by LTIAAS. If you have any questions or concerns about the use of any trademarks or content on this website, please contact us.