API

Terminology

An overview of the novem terminology

AI assisted, human approved — novem uses AI to review and keep our documentation up to date.

Novem is a fairly complicated platform and to make sure we're all talking about the same thing we've created a set of technical terms with explicit meaning.

This page provides a list and definition of the important technical terms and their definition.

The fully qualified novem path is how we refer to objects and entities within the novem platform. The FQNP gives a 100% unique string representation of all resources on the novem platform.

FQNPs are designed to be typeable, URL friendly, hierarchical and intuitive.

Novem resources are owned by either users or organisations, as such there are two root nodes in FQNP, either /u/ or /o/.

By convention all partial FQNPs should alternate between a general and a specific part with the general part listing the available options (conditioned on access). As such /u/ should list all users and /u/username/ should list all resources available for username.

Below we use the example of a plot variable as a fairly complex FQNP, but other visualisations, jobs and repos exhibit similar patterns.

For example, to reference a variable published on a novem plot you could reference it as follows:

/u/novem_demo
The novem user

Plot IDs are not globally unique, only usernames and organisations are. Therefore all FQNPs start with either /u/username or /o/orgid.



/u/ or /o/ on their own refers to all users or all orgs (that you can see).

/p/price_chart
The specific chart

Plot IDs are unique per user so this part selects a specific plot owned by this user. For mails, grids or docs use their respective 1-letter codes (/m, /g, /d). Jobs and repos live under the /code/ namespace as full words (/code/jobs/:job, /code/repos/:repo) rather than a single-letter code.



Similar to /u/ using just the /p/ will refer to all the user's accessible plots.

/v/close_price
The chart variable

The lowest level novem offers is individual data points on a vis/repo/job. These variables are individually set and globally accessible.



With no further information the default behavior is to color by a linear gradient interpolated between the two colors based on the underlying values in the filtered region.

Every visualisation, repo, and job also gets a shortname: a compact, globally unique id (unlike an FQNP, it doesn't need the owner prefix). You'll find it at each resource's shortname path, and it's what the public share links and the /i alias below are keyed on.

Alongside the /v1/... management tree, novem exposes a set of read-oriented aliases. They serve JSON and pre-rendered output directly, without the filesystem-style navigation, and honour the same access rules. Public resources work without a token. Everything else needs one with read access.

PathDescription
/v1/u/:userA user's public info and the visuals you can see, under the one-letter codes (p, g, m, d, v)
/v1/u/:user/imgThe user's avatar — what embeds and link previews point at
/v1/u/:user/cardThe user's profile card
/v1/u/:user/bannerThe user's profile banner
/v1/u/:user/fThe user's activity feed
/v1/o/:orgThe organisation equivalent — card, banner, img and the org's visuals under p / g / m / d / v
/v1/i/:shortnameAny visualisation by its shortname — renders (img, pdf, pptx, csv, xlsx, txt, ansi, mhtml), assets and vars (v), without needing to know its type or owner
/v1/tYour tags, expanded
/v1/t/:tagA category tag's public listing — the discoverable =-prefixed categories

VerbPathDescription
POST/v1/abuseReport a user or piece of content for abuse
Next
Authentication