Skip to main content

Letter and patient document title byte limit

Summary​

createLetter, updateLetter, and createPatientDocument now reject title / name values longer than 128 UTF-8 bytes (not Unicode code points). Accented characters count as multiple bytes in UTF-8.

This aligns with DMP (Mon Espace Santé) constraints and matches validation in the Semble web app.

Affected GraphQL fields​

Operation / typeFieldLimit
createLetter / CreateLetterDataInputtitle128 UTF-8 bytes
updateLetter / UpdateLetterDataInputtitle128 UTF-8 bytes (when provided)
LettertitleSame limit on write
createPatientDocumentname128 UTF-8 bytes
PatientDocumentnameSame limit on write

Field descriptions in the GraphQL schema document this limit. Validation errors return a message indicating the title or name is too long.

Migration​

  1. Refresh your schema snapshot and regenerate GraphQL clients so field descriptions are visible in your tooling.
  2. Before calling createLetter, updateLetter, or createPatientDocument, ensure title / name encodes to at most 128 UTF-8 bytes (use UTF-8 byte length in your language, not string.length alone).
  3. If a name was previously accepted but exceeds the limit, shorten it in your integration; the API will not truncate automatically.
  4. Existing documents with oversized names are unchanged until the next update; updates that exceed the limit are rejected.

See also​