Skip to main content
POST
Create a tag

Authorizations

Authorization
string
header
required

A Nemonist key (sk-nm-...) as a bearer token in the Authorization header.

Path Parameters

id
string
required

The folder's id (fld_...), as GET /folders lists it.

Body

application/json

The tag to make.

name
string
required

The tag's name: 1 to 100 letters, digits and . _ - / as git check-ref-format allows: no space, no .., no // or part starting with ., not ending in /, . or .lock, not starting with -.

commit
string
required

A commit id or a tag name. HEAD (the newest commit) and ~N (N commits older) work too, as git rev-parse; past the kept history is a 404.

message
string

An optional message, at most 500 characters.

Response

The new tag.

A tag: a name for one commit (git tag, GitHub's /tags).

name
string
required

The tag's name.

commit
string
required

The commit it names.

kept
boolean
required

Whether the folder's kept history still holds its commit; false: the commit aged out, and the tag no longer resolves.

message
string

Its message, if given.

by
string

Who made it.

created
string

When it was made (ISO 8601).

commitAt
string

With kept: the commit's time.

commitMessage
string

With kept: the commit's message.

html_url
string

With kept: the commit on the dashboard.

tree_url
string

With kept: GET it for the notes at the tag.

zipball_url
string

With kept: GET it for the notes at the tag as a zip.