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. | – |