Skip to content

POST /v1/notes requires undocumented 'lastMutationAt' field #74

@sharabash

Description

@sharabash

Summary

Same issue as #73 but for the notes endpoint. POST /v1/notes returns 422 Unprocessable Entity with "lastMutationAt" is required, but this field is not documented.

Observed behavior

Request:

{
  "body": "The youth of the Cave chose faith over comfort...",
  "saveToQR": false,
  "ranges": ["18:10-18:10"]
}

Response: 422 Unprocessable Entity

{
  "details": {
    "success": false,
    "error": {
      "code": "ValidationError",
      "message": "\"lastMutationAt\" is required",
      "details": {"lastMutationAt": "MISSING"}
    }
  },
  "message": "\"lastMutationAt\" is required",
  "type": "unprocessable_entity",
  "success": false
}

Notes

  • The field was also sent in the JSON body — the API still reports it as MISSING, suggesting the schema's additionalProperties: false strips it before business logic validation runs.
  • This likely affects all write endpoints (bookmarks, notes, reading sessions).
  • Related: POST /v1/bookmarks requires undocumented 'lastMutationAt' field #73

Tested against: https://apis-prelive.quran.foundation/auth/v1/notes

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions