HYPOTHESIS-CLIENT(1)

hypothesis-client(1) 💖

okay bestie, welcome to the group chat. this is the manual page for hypothesis-client, living in the User Commands section of the manual, and today we're talking about ONE (1) subcommand. grab a snack. 🍓

---

✨ NAME ✨

hypothesis-client annotations update — Update an existing annotation

that's it. that's the whole name. lowkey iconic that it's a whole sentence.

---

✨ SYNOPSIS ✨

hypothesis-client annotations update [OPTIONS] <ID> [URI]

---

✨ DESCRIPTION ✨

Update an existing annotation

like. you already made the annotation. you want to touch it up. this is the tool for that. no cap. 💅

Arguments:

• <ID> — the unique ID of the annotation you wanna update. it's the one that comes FIRST, and it's not optional, so don't come at me without it. 🙈
• [URI] — the URI that this annotation is attached to. it lives in square brackets so it's optional, bestie.

this can be a URL (you know, a web page address) or a URN representing another kind of resource, like a DOI (Digital Object Identifier) or a PDF fingerprint. so many options, so much range. 🌈

[default: ]

yes, the default is literally empty. nothing there. a whole void. it's giving minimalist. ⭐

---

✨ OPTIONS ✨

• --text <TEXT> — the annotation text / comment given by user.

🚨 THIS IS NOT THE SELECTED TEXT ON THE WEB-PAGE. 🚨 this is YOUR commentary, your hot take, your thoughts-and-prayers about whatever you highlighted. do not confuse the two, i am begging. 😭

[default: ]

• --tags <TAGS> — tags attached to the annotation. you know, the lil labels. the vibes-organizers. 🎀
• --group <GROUP> — the unique identifier for the annotation's group.

here's the tea: if an annotation is a reply to another annotation (see references), this field will be ignored — replies belong to the same group as their parent annotations. so don't waste your time setting it, it's not gonna listen to you. 💀

[default: ]

• --references <REFERENCES> — annotation IDs for any annotations this annotation references (like, for example, is a reply to). it's the annotation family tree. 🌸
• -o, --file <FILE> — write the updated annotation to this file in JSON format. like a little souvenir of your edit. 🎁
• -h, --help — Print help (see a summary with '-h'). the classic. the goat. use it when you forget everything i just said. 👑

---

👑 the sign-off 👑

this whole page is sourced from the hypothesis-client annotations docs, dated August 2025, and yes the version/date line at the bottom of the original page is also exactly that. so like, if you're reading this in the far-flung future of 2026, hi, hope you're well, slay. 🦋

go update your annotations bestie, you're doing amazing, periodt. 💜✨