Profile

Your profile is how you appear to the rest of novem. It collects your display name, picture, bio and registered e-mail addresses, and it backs your public profile page at https://novem.io/u/<your_username> — the page other users land on when they follow a link to your shared visualisations.

Like everything else on the platform the profile is a hierarchical folder, rooted at /admin/profile/. Each field is a file you read with GET and update with POST; folders such as emails and picture group the more involved settings.

Structure

profile                       => Your profile (/admin/profile)
├── name                      => Display name
├── bio                       => Short bio
├── description               => Longer free-form description
├── timezone                  => Your timezone (e.g. Europe/Oslo)
├── picture                   => Profile imagery
│   ├── image                 => Profile picture / avatar
│   ├── banner                => Profile banner
│   └── mask                  => Crop/framing for the picture (x,y,r)
├── emails                    => Your registered e-mail addresses
│   └── <email>               => A single address
│       ├── address           => The address itself
│       ├── status            => Verification status / challenge
│       ├── primary           => Whether this is your primary address
│       └── log               => Delivery & verification log
├── email                     => Your primary e-mail (read-only)
├── public                    => Public/private profile toggle
├── options                   => Per-field visibility on your public profile
│   ├── show_name             => Show your display name
│   ├── show_email            => Show your e-mail
│   └── show_description       => Show your description
├── password                  => Change your password (write-only)
├── overview                  => Human-readable summary (read-only)
├── url                       => Your public profile URL (read-only)
└── log                       => Profile activity log (read-only)

Identity

The fields that describe you are plain text files you write with POST.

• name — your display name, shown alongside your username wherever your content surfaces.
• bio — a short bio. This is the line that appears on your public profile and in your profile overview.
• description — a longer, free-form description for when a single line isn't enough.
• timezone — an IANA timezone such as Europe/Oslo, used to render dates and schedule-related times in your local time.

novem --post /admin/profile/name "Ada Lovelace"
novem --post /admin/profile/bio "Numbers, engines and the occasional chart."
novem --post /admin/profile/timezone "Europe/London"

Profile picture

Your imagery lives under picture/. Both the avatar and the banner are uploaded by POSTing the image to the corresponding endpoint, read back with GET, and removed with DELETE.

• picture/image — your profile picture (avatar).
• picture/banner — the wide banner shown across the top of your public profile.
• picture/mask — controls how the picture is framed. It's a plain-text x,y,r triple giving the crop centre and radius, as percentages (e.g. 50,50,40) or pixels (120px,80px,90px).

E-mail addresses

You can register more than one e-mail address. Each lives under emails/ as its own folder, named by the address.

• Add an address by PUTting its name under emails/, then POST the address to its address file.
• status drives verification: POST verify to (re)send a verification e-mail, then POST the 6-digit code from that e-mail to complete the challenge.
• primary marks which verified address is your primary one.
• log records delivery and verification events for that address.

The read-only email file at the profile root resolves to your effective address — your primary if set, otherwise your first verified address, otherwise the first one you added.

# register a new address
novem --put  /admin/profile/emails/work
novem --post /admin/profile/emails/work/address "ada@example.com"

# send the verification e-mail, then submit the code you receive
novem --post /admin/profile/emails/work/status verify
novem --post /admin/profile/emails/work/status 123456

# make it your primary address
novem --post /admin/profile/emails/work/primary true

Visibility & privacy

By default a profile is private. The public toggle controls whether your profile page is visible to others at all — POST true to make it public or false to take it private again.

When your profile is public, the options/ folder gives you per-field control over what's actually shown:

• options/show_name — show your display name.
• options/show_email — show your e-mail address.
• options/show_description — show your description.

Each is a true/false toggle, so you can have a public profile that still keeps, say, your e-mail address hidden.

true

Password

The write-only password endpoint changes your account password. It only accepts POST and never returns the current value.

Overview, URL and log

Three read-only endpoints summarise your profile:

• overview — a human-readable summary of your account: display name, username, e-mail, bio, avatar, subscription, member-since date and remaining invites. Handy for a quick GET to confirm how your profile looks.
• url — your canonical public profile URL, https://novem.io/u/<your_username>.
• log — an activity log of changes to your profile.

novem --get /admin/profile/overview

SSH keys

To push to a repo over SSH, register a public key on your account. Keys live under /admin/keys, addressed by name, and a single key works for all of your repos.

See registering an SSH key in the repo guide for a worked example.

Notifications

Two trees under /admin/notifications govern what novem tells you about and let you read what it already has.

Preferences (control)

control holds one setting per event type, grouped by class. Each leaf is a plain-text file you GET to read and POST to set to one of the option values ignore, info (default) or important. A GET on control or any class folder lists its members.

For example, to stop being notified when a job starts but stay notified when one fails:

novem --post /admin/notifications/control/job/job_start ignore
novem --post /admin/notifications/control/job/job_fail important

Per-resource overrides live on each resource's own notifications file (e.g. a single plot or grid), which takes precedence over these account defaults.

Inbox (list)

Next steps

• Social — connect with and follow other users from your profile.
• Authentication — tokens, login and the whoami endpoint.