---
name: "hypothesis-client-annotations-create"
section: "1"
platform: "linux"
package: "hypothesis-client"
version: "0.12.0-3+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hypothesis-client-annotations-create"
---

# hypothesis-client-annotations-create(1)

Create a new annotation (TODO: add Target somehow)

## NAME

hypothesis-client annotations create - Create a new annotation (TODO: add Target somehow)

## SYNOPSIS

**hypothesis-client** *annotations create* \[*OPTIONS*\] \[*URI*\]

## DESCRIPTION

Create a new annotation (TODO: add Target somehow)

### Arguments:

-

  \[URI\]

-

  URI that this annotation is attached to.

-

  Can be a URL (a web page address) or a URN representing another kind of resource such as DOI (Digital Object Identifier) or a PDF fingerprint.

-

  \[default: \]

## OPTIONS

**--text** \<TEXT\>

-

  Annotation text / comment given by user

-

  This is NOT the selected text on the web-page

-

  \[default: \]

**--tags** \<TAGS\>

-

  Tags attached to the annotation

**--group** \<GROUP\>

-

  The unique identifier for the annotation's group.

-

  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.

-

  \[default: \]

**--references** \<REFERENCES\>

-

  Annotation IDs for any annotations this annotation references (e.g. is a reply to)

**-o**, **--file** \<FILE\>

-

  write created annotation to this file in JSON format

**-h**, **--help**

-

  Print help (see a summary with '-h')