For Developers

Warning Codes

This page contains a list of common warnings you might come across while using the Edlink API. For a breakdown of how to process warnings, check out our guide on errors and warnings. Warnings represent a non-fatal issue with your request. They are not guaranteed to be returned, and they are not guaranteed to be returned in any particular order. They are meant to be informational, and you should not rely on them to determine the success or failure of your request.

You can control whether some requests fail (with errors) or succeed (with warnings) by toggling various feature flags in your application settings. Opting for these requests to complete with warnings may be useful for user experience, but can sometimes lead to uunexpected results if you are not careful.

Warnings

CodeDescription
ASSIGNEES_IGNOREDWhen the assignee_mode is set to all, the value of the assignee_ids field is ignored.
AUTOFILLED_DEFAULTYour submission did not conform to the LMS standards so we have Autofilled Data on a default field.
COULD_NOT_FIND_IDOne or more person_ids specified in the request could not be found. Please note that the search area only includes people who are enrolled in the class related to your request. For instance, you cannot assign an assignment to a person who is not enrolled in the class.
DATETIME_MISSING_TIMEZONEYou've included a date without a timezone. We'll assume you mean UTC. Please review our guide on dates.
FOUND_UNEXPECTED_FIELDYou've included a field in the request body that we don't know how to handle. It will be ignored.
IDEMPOTENCY_KEY_REPEATEDThis warning is triggered when you use the same $idempotency key more than once. We'll return the exact same response that we did the previous time you used the given $idempotency key. Please review our guide on idempotency.
IDEMPOTENCY_KEY_IGNOREDThe provided $idempotency key is ignored by Edlink when the endpoint is already idempotent. There is no harm in providing one anyway, but it won't be used. Please review our guide on idempotency.
INVALID_EXPANSIONOnly certain fields are allowed to be $expanded. Please review our guide on expanding results.
INVALID_PATCH_PROPERTYOnly certain fields are allowed to be specified using $properties. Please review our guide on patch requests.
INVALID_FIELD_REQUESTEDOnly certain fields (the ones that we provide) are allowed to be requested using $fields. Please review our guide on limiting fields.
PAGING_IGNOREDWhen the $cursor parameter is used, it overrides all other paging parameters. We recommend using the $next url exactly as it comes out of the Edlink API, without any adjustments. Please review our guide on pagination.
PROVIDER_IGNORED_PAGE_SIZESome providers may not respect the $first parameter. Please review our guide on pagination.
SUBMISSION_PERCENT_GRADE_FORMATAssignment grading type is percent. Submission grade should be formatted like '89.5%' (decimal optional).
UNUSED_SUBMISSION_GRADE_POINTSSubmission grade_points was given, which does not match with the assignment grading type.
UNUSED_SUBMISSION_GRADESubmission grade field was given, which does not match with the assignment grading type.
MISSING_SUBMISSION_GRADE_POINTSSubmission grade_points is required to update the grade for this assignment.
MISSING_SUBMISSION_GRADESubmission grade is required to update the grade for this assignment.
UNSUPPORTED_SUBMISSION_TYPEThe 'submission_types' field was not an array. It has been converted to an array containing the single value that you sent.
UNSUPPORTED_ATTACHMENT_TYPEThe provided attachment type is not supported.
UNSUPPORTED_ASSIGNMENT_PROPERTIESThe values in assignment.properties are not supported and wont be used by the source system in the creation of the assignment.
MISSING_DISPLAY_DATEThe display_date is required for this assignment. Edlink may default to the current date if no display_date is provided.
NO_ASSIGNEESThis warning means that one of the assignments returned to you had an assignee mode of none which is used to denote an assignment that is shared with a class but assigned to no one

Blackboard Warnings

StatusCodeDescription
BLACKBOARD_CANNOT_UPDATE_GRADER_IDBlackboard does not support updating the grader_id on a submission. Field is ignored.
BLACKBOARD_CANNOT_UPDATE_FLAGSBlackboard does not support updating the excused, late, or missing flags on a submission. Field is ignored.
BLACKBOARD_CANNOT_UPDATE_GRADEBlackboard does not support updating the grader_id on a submission. Field is ignored.
BLACKBOARD_CANNOT_OVERRIDE_DUE_DATEBlackboard does not support setting an override_due_date on a submission. Field is ignored.
BLACKBOARD_CANNOT_SET_EXTRA_ATTEMPTSBlackboard does not support setting extra_attempts on a submission. Field is ignored.

Brightspace Warnings

StatusCodeDescription
BRIGHTSPACE_CANNOT_UPDATE_FIELDBrightspace does not support updating one of the attempted fields on a submission. Field is ignored.

Canvas Warnings

StatusCodeDescription
CANVAS_NO_RETURNCanvas has no concept of a submission 'returned' state. This operation is a no-op.

Google Warnings

StatusCodeDescription
GOOGLE_CANNOT_UPDATE_ATTACHMENTSGoogle Classroom does not allow updating assignment attachments. Field is ignored.
GOOGLE_CATEGORY_NAME_WHITESPACEThe name of the topic contains leading or trailing whitespace.

LTI Warnings

StatusCodeDescription
LTI_UNSUPPORTED_ASSIGNEE_MODEAssignee mode has been set to all, which is the only valid option for LTI integrations.
LTI_UNSUPPORTED_GRADING_TYPEGrading type has been set to points, which is the only valid option for LTI integrations.
LTI_UNSUPPORTED_SUBMISSION_TYPESubmission type has been set to link, which is the only valid option for LTI integrations.
LTI_UNSUPPORTED_SUBMISSION_BODYLTI does not support submission bodies. Sorry.

Microsoft Warnings

StatusCodeDescription
MICROSOFT_UNUSED_START_DATEMicrosoft doesn't have separate fields for 'display_date' and 'start_date'. Value of 'start_date' is unused.
MICROSOFT_LINK_ATTACHMENT_DESCRIPTIONMicrosoft does not support descriptions on link attachments. Field is ignored.
MICROSOFT_UNSUPPORTED_ATTACHMENT_TYPEMicrosoft does not support the provided attachment type.
MICROSOFT_CANNOT_UPDATE_GRADER_IDMicrosoft does not support updating the grader_id on a submission. Field is ignored.
MICROSOFT_CANNOT_UPDATE_FLAGSMicrosoft does not support updating the excused, late, or missing flags on a submission. Field is ignored.
MICROSOFT_CANNOT_UPDATE_GRADEMicrosoft does not support grade, only grade_points. Field is ignored.
MICROSOFT_CANNOT_OVERRIDE_DUE_DATEMicrosoft does not support setting an override_due_date on a submission. Field is ignored.
MICROSOFT_CANNOT_SET_EXTRA_ATTEMPTSMicrosoft does not support setting extra_attempts on a submission. Field is ignored.

Schoology Warnings

StatusCodeDescription
UNSUPPORTED_ATTACHMENT_DESCRIPTIONThe File attachment description field is not supported for Schoology, and will be ignored.