Errors

Owlflow returns request-level failures in GraphQL's top-level errors array. auth.createUser and viewer.updateUser return validation errors inside errors { code field message } and set success to false.

json

{
  "errors": [
    {
      "message": "Authentication required",
      "extensions": {
        "code": "UNAUTHENTICATED",
        "requestId": "550e8400-e29b-41d4-a716-446655440000"
      }
    }
  ]
}

Code	Meaning
`UNAUTHENTICATED`	Missing or invalid Bearer token.
`FORBIDDEN`	The student can't perform this action.
`BAD_USER_INPUT`	A field failed validation.
`UPSTREAM_ERROR`	Owlflow couldn't complete the call to its backend.
`INTERNAL`	Unexpected server error.

Each error includes a requestId. Include requestId when contacting ScholarshipOwl so the team can trace the failed request.

Call health for a liveness check. Owlflow returns a string and doesn't access student data.

Errors ​

Errors