Errors

GraphQL errors arrive in the errors array. Validation on signup and profile save also returns errors { code field message } on the mutation payload, with success: 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 cannot perform this action.
`BAD_USER_INPUT`	A field failed validation.
`UPSTREAM_ERROR`	Owlflow could not complete the call to its backend.
`INTERNAL`	Unexpected server error.

requestId is on every error. Include it when you report a failure.

health returns a string and no student data. Use it as a liveness check.

Errors ​

Errors