API Errors

Woolf’s Airlock API uses structured error handling to help you detect and resolve issues during integration. Errors are returned in two forms: network errors and GraphQL errors.


Understanding API Errors

  • Network errors return no data and result in standard HTTP error status codes like: 400, 401, 413, 429, 500, 504.
  • GraphQL errors appear inside the response and may return partial data in a query, but mutations will not execute.
⚠️ A 401 Unauthorized response usually means your College Token is invalid, expired, or lacks required permissions.

System Error Codes

The following table lists the most common system-level API error codes and their descriptions:

Code Message Field
IMPORT_FAILED We are unable to access the provided URL. importUrl
USER_NOT_FOUND Ensure the user is added to your college using their email.
STUDENT_NOT_FOUND Ensure the student is added to your college.
TEACHER_NOT_FOUND Ensure the teacher is added to your college.
DEGREE_NOT_FOUND Verify that the degree exists in your college.
RESOURCE_NOT_FOUND The requested resource does not exist or is not accessible.
WEIGHT_NOT_FOUND A grade weight is not defined for this resource. weights
COLLEGE_NOT_VERIFIED Your college must be verified before using this API operation.
DEGREE_NOT_VERIFIED This degree is not verified and cannot be used yet.
STUDENT_NOT_COMPLIANT This student has not yet completed a program. email, rejectionReasons
RESOURCE_ALREADY_EXISTS This resource ID is already in use within your college.
ACTIVITY_NOT_FOUND The specified activity ID does not exist.
INVALID_ACTIVITY This activity cannot be modified.
INVALID_GRADE Grades must be between 0 and 100.
UNKNOWN_ATTRIBUTION You must provide either an activity ID or a resource + student ID.
INVALID_STUDENT This student cannot be created or has an invalid status.
INVALID_ASSET Asset is missing import URL or content type.
STUDENT_ALREADY_EXISTS A student with this email or ID already exists.

Explore More