CENSUS ANNOTATE(1)

NAME
census-annotate - Annotate an attestation with forensic...

SYNOPSIS
census annotate [OPTIONS] ATTESTATION_ID

DESCRIPTION
Annotate an attestation with forensic metadata.

    Attach notes, tags, or case identifiers to existing attestations
    via the CertiSigma API. Use --encrypt for zero-knowledge mode
    where the server never sees plaintext metadata.

    Examples:
        census annotate att_123 --note "Evidence collected 2026-03-18"
        census annotate att_123 --tag "case-2026-001" --case-id "FR-2026-42"
        census annotate att_123 --note "Confidential" --encrypt
        census annotate att_123 --delete

OPTIONS

--note TEXT
    Free-text note for the attestation.

--tag TEXT
    Tag label (e.g. case number, department).

--case-id TEXT
    Forensic case identifier.

--source TEXT
    Update the source label.

--delete
    Soft-delete metadata (GDPR right-to-erasure).

--encrypt
    Encrypt metadata client-side (AES-256-GCM) before sending.

--encryption-key TEXT
    Hex AES-256 key (64 chars). Default: from config.

--decrypt
    After annotation, try to decrypt and display the stored metadata.

--json
    Machine-readable JSON output.

--api-key TEXT
    CertiSigma API key.

--base-url TEXT
    API base URL override.