variant/put

Submit a new or modified segment reading witness attestation.

Parameters

NameRequiredDefaultDescriptionExample
segmentIDtrueN/Asegment id at which an attestation is being made18582
docIDtrueN/Amanuscript id which is attesting to a reading at a segment10046
verseInstancefalseverse instance identifier to disambiguate for manuscripts which have multiple attestations to the same verse at a segment. This is used when a witness repeats the same verse multiple times, e.g., a commentary or lectionary may have multiple occurances of John 3:16 within the document. This field allows a designator to specify which occurance a witness attestation is being created or modifiedA
handfalsewhich scribal hand within a witness, other than the original scribe, is attesting to a reading at a segment (i.e., if a corrector is witnessing differently from the original hand)C1
segmentReadingIDtrueN/Awhich reading is being attested to by this witness at this segment27932
unsurefalsefalseif this reading is unsure, i.e. ut videtur (= V)true
unsureMajorfalsefalseif this reading is unsureMajor, i.e. ut videtur (= V) with supplied which spans an entire word or moretrue
regularizedfalsefalseif this reading is regularized (= r) to a point that we wish to mark it as such. It may not be a desire to markup some minor or common regularizations, like NomSacstrue
supplementfalsefalseif this reading is from a document supplement (= S) and not the original production unittrue
nonsensefalsefalseif this reading is determined nonsensical, i.e. Fehler (= f), a non-deliberate scribal errortrue
omHapfalsefalseif this reading contains an omission and determined haplography (= lacuna H)true
omComAbbrfalsefalseif this reading contains an omission and determined commentary abbreviated (= lacuna A)true
lacWordsfalsefalsesome readings are lacuna at certain words (unsureMajor, omHap, omComAbbr). This fields allow one to say which full words this witness is fully lacunatrue
siglumSuffixfalse[use boolean flags above instead of {siglumSuffix}, if possible] any suffix to add to the witness siglum when displaying; this overrides any computed suffix from {unsure}, {unsureMajor}, {regularized}, {supplement}, {nonsense}, {omHap}, {omComAbbr} (VrSfHA)rV
transcriptionfalsethe witness transcription at this pointΧριστου
subLabelfalsesubLabel suffix for the segment reading labelo
altSublabelTranscriptionfalseAlternate subLabel reading transcription. Sublabel transcriptions are normally simply the original witness transcription, but if this is not the desire for this instance (due to regularization) the subLabel reading text can be supplied hereΙησου
siglumGroupQualifierfalseIf this siglum represents a witness group, this allows additional qualification of that group at this location+1022, -1549
commentPrivatefalseComment regarding this segment reading witness attestation. Meant only for internal team use
commentPublicfalseComment regarding this segment reading witness attestation. Meant for publication
commentSegmentPublicfalseComment regarding this segment witness attestation. Meant for publication
projectIDfalsekeep this entry within an alternate projectID, overriding the default segmentGroupID1
projectNamefalsespecify {projectID} by supplying a project nameECM Matthew
addChecksumfalsefalsewhether or not to include a checksum for the segment and reading, for checking and syncing back to modified segments and readings. Useful for versionists who add data to an apparatus which may change from under themtrue
formatfalsespecified at session openresponse output format (json|xml|csv|gchart)json

Errors

{docID} may not be null-4
{segmentID} may not be null-4