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
Code | Description |
---|---|
ASSIGNEES_IGNORED | When the assignee_mode is set to all , the value of the assignee_ids field is ignored. |
AUTOFILLED_DEFAULT | Your submission did not conform to the LMS standards so we have Autofilled Data on a default field. |
COULD_NOT_FIND_ID | One or more person_id s 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_TIMEZONE | You've included a date without a timezone. We'll assume you mean UTC. Please review our guide on dates. |
FOUND_UNEXPECTED_FIELD | You've included a field in the request body that we don't know how to handle. It will be ignored. |
IDEMPOTENCY_KEY_REPEATED | This 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_IGNORED | The 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_EXPANSION | Only certain fields are allowed to be $expand ed. Please review our guide on expanding results. |
INVALID_PATCH_PROPERTY | Only certain fields are allowed to be specified using $properties . Please review our guide on patch requests. |
INVALID_FIELD_REQUESTED | Only certain fields (the ones that we provide) are allowed to be requested using $fields . Please review our guide on limiting fields. |
PAGING_IGNORED | When 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_SIZE | Some providers may not respect the $first parameter. Please review our guide on pagination. |
SUBMISSION_PERCENT_GRADE_FORMAT | Assignment grading type is percent. Submission grade should be formatted like '89.5%' (decimal optional). |
UNUSED_SUBMISSION_GRADE_POINTS | Submission grade_points was given, which does not match with the assignment grading type. |
UNUSED_SUBMISSION_GRADE | Submission grade field was given, which does not match with the assignment grading type. |
MISSING_SUBMISSION_GRADE_POINTS | Submission grade_points is required to update the grade for this assignment. |
MISSING_SUBMISSION_GRADE | Submission grade is required to update the grade for this assignment. |
UNSUPPORTED_SUBMISSION_TYPE | The 'submission_types' field was not an array. It has been converted to an array containing the single value that you sent. |
UNSUPPORTED_ATTACHMENT_TYPE | The provided attachment type is not supported. |
UNSUPPORTED_ASSIGNMENT_PROPERTIES | The values in assignment.properties are not supported and wont be used by the source system in the creation of the assignment. |
MISSING_DISPLAY_DATE | The display_date is required for this assignment. Edlink may default to the current date if no display_date is provided. |
NO_ASSIGNEES | This 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
Status | Code | Description |
---|---|---|
BLACKBOARD_CANNOT_UPDATE_GRADER_ID | Blackboard does not support updating the grader_id on a submission. Field is ignored. | |
BLACKBOARD_CANNOT_UPDATE_FLAGS | Blackboard does not support updating the excused, late, or missing flags on a submission. Field is ignored. | |
BLACKBOARD_CANNOT_UPDATE_GRADE | Blackboard does not support updating the grader_id on a submission. Field is ignored. | |
BLACKBOARD_CANNOT_OVERRIDE_DUE_DATE | Blackboard does not support setting an override_due_date on a submission. Field is ignored. | |
BLACKBOARD_CANNOT_SET_EXTRA_ATTEMPTS | Blackboard does not support setting extra_attempts on a submission. Field is ignored. |
Brightspace Warnings
Status | Code | Description |
---|---|---|
BRIGHTSPACE_CANNOT_UPDATE_FIELD | Brightspace does not support updating one of the attempted fields on a submission. Field is ignored. |
Canvas Warnings
Status | Code | Description |
---|---|---|
CANVAS_NO_RETURN | Canvas has no concept of a submission 'returned' state. This operation is a no-op. |
Google Warnings
Status | Code | Description |
---|---|---|
GOOGLE_CANNOT_UPDATE_ATTACHMENTS | Google Classroom does not allow updating assignment attachments. Field is ignored. | |
GOOGLE_CATEGORY_NAME_WHITESPACE | The name of the topic contains leading or trailing whitespace. |
LTI Warnings
Status | Code | Description |
---|---|---|
LTI_UNSUPPORTED_ASSIGNEE_MODE | Assignee mode has been set to all , which is the only valid option for LTI integrations. | |
LTI_UNSUPPORTED_GRADING_TYPE | Grading type has been set to points , which is the only valid option for LTI integrations. | |
LTI_UNSUPPORTED_SUBMISSION_TYPE | Submission type has been set to link , which is the only valid option for LTI integrations. | |
LTI_UNSUPPORTED_SUBMISSION_BODY | LTI does not support submission bodies. Sorry. |
Microsoft Warnings
Status | Code | Description |
---|---|---|
MICROSOFT_UNUSED_START_DATE | Microsoft doesn't have separate fields for 'display_date' and 'start_date'. Value of 'start_date' is unused. | |
MICROSOFT_LINK_ATTACHMENT_DESCRIPTION | Microsoft does not support descriptions on link attachments. Field is ignored. | |
MICROSOFT_UNSUPPORTED_ATTACHMENT_TYPE | Microsoft does not support the provided attachment type. | |
MICROSOFT_CANNOT_UPDATE_GRADER_ID | Microsoft does not support updating the grader_id on a submission. Field is ignored. | |
MICROSOFT_CANNOT_UPDATE_FLAGS | Microsoft does not support updating the excused, late, or missing flags on a submission. Field is ignored. | |
MICROSOFT_CANNOT_UPDATE_GRADE | Microsoft does not support grade , only grade_points . Field is ignored. | |
MICROSOFT_CANNOT_OVERRIDE_DUE_DATE | Microsoft does not support setting an override_due_date on a submission. Field is ignored. | |
MICROSOFT_CANNOT_SET_EXTRA_ATTEMPTS | Microsoft does not support setting extra_attempts on a submission. Field is ignored. |
Schoology Warnings
Status | Code | Description |
---|---|---|
UNSUPPORTED_ATTACHMENT_DESCRIPTION | The File attachment description field is not supported for Schoology, and will be ignored. |