Skip to main content
Hjarni logo
  • Category: notes
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 15
  • Triggers: 0
  • Slug: HJARNI
  • Version: 20261101_00

Tools

Slug: HJARNI_CREATE_CONTAINERCreate a root or nested Hjarni container for organizing notes.

Input Parameters

string
required
Container name.
integer
Optional order position among sibling containers.
integer
Parent container ID; omit to create a root container.
string
Optional container description.
string
Optional AI instructions scoped to this container.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_CREATE_NOTECreate a Markdown note in the inbox or a container. Tags named in tag_names are applied as part of creation. Free accounts are limited to 25 notes, so check account status if quota pressure is possible.

Input Parameters

string
Markdown note body.
string
required
Note title.
string
Optional note summary.
integer
Optional position within the destination scope.
array
Tag names to apply to the note.
string
Optional URL from which the note content originated.
integer
Destination container ID; omit to create the note in the inbox.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_CREATE_NOTESCreate 1–25 Markdown notes in order and return a result per input. The batch is non-atomic; outcomes can be created, failed, unknown, or not attempted, and processing stops after an account-wide or ambiguous failure.

Input Parameters

array
required
Notes to create in order (1-25). The batch is non-atomic: successful notes remain created if another item fails.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_CREATE_TAGCreate a Hjarni tag for organizing notes.

Input Parameters

string
required
Non-blank tag name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_GET_ACCOUNT_STATUSReturn the connected Hjarni identity and available account status, including plan, teams, resource usage, and quotas where provided; agent tokens receive a reduced response. Free accounts allow 25 notes, 5 attachments, and 20 MB of attachment storage.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_GET_NOTEGet one Hjarni note by ID with its Markdown body, tags, container, attachments, links, and optimistic-lock version.

Input Parameters

integer
required
ID of the note to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_LIST_CONTAINERSList Hjarni containers with options for archived or all active containers, and use next_cursor to page through results. By default, full-access tokens return active roots; agent tokens return reachable active folders in a flat list.

Input Parameters

string ("archived" | "all")
Container subset: omit for active roots, archived for archived roots, or all for all active containers in a flat view.
integer
Maximum containers in this page (1-100).
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_LIST_NOTESList and filter Hjarni notes by active, inbox, archived, or favorited scope, using next_cursor to page through results. Access depends on the token, and full-access favorites can include team notes; note bodies are omitted by default.

Input Parameters

string
Only return notes carrying this tag name.
string
Optional text filter for personal notes.
string ("archived" | "inbox" | "favorited")
Optional note subset; omit for active notes.
integer
Maximum notes in this page (1-100).
string
Continuation cursor returned by a previous call; omit for the first page.
integer
Only return notes directly in this container.
boolean
Omit note bodies to reduce response size; set false when bodies are needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_LIST_TAGSList all Hjarni tags and their note counts. Use next_cursor to page through results.

Input Parameters

integer
Maximum tags in this page (1-100).
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_LIST_TRASHED_NOTESList recoverable trashed Hjarni notes with their deletion and scheduled purge times. Use next_cursor to page through results.

Input Parameters

integer
Maximum trashed notes in this page (1-100).
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_RENAME_TAGRename an existing Hjarni tag without changing its note associations.

Input Parameters

string
required
New non-blank tag name.
integer
required
ID of the tag to rename.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_RESTORE_NOTERestore a note from Trash before its scheduled purge and return the restored note. Notes deleted together with their folder must be restored with the folder, not individually.

Input Parameters

integer
required
ID of the trashed note to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_TRASH_NOTEMove a note to recoverable Trash. This is not immediate permanent deletion: Hjarni retains the note for about 30 days, and RESTORE_NOTE can recover it before purge.

Input Parameters

integer
required
ID of the note to move to recoverable Trash.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_UPDATE_CONTAINERUpdate a Hjarni container’s name, description, parent, position, or container-specific AI instructions.

Input Parameters

string
Replacement name.
integer
Replacement order position among sibling containers.
integer
Move under this parent. Explicit null moves the container to the root; omission leaves the parent unchanged.
string
Replacement description.
integer
required
ID of the container to update.
string
Replacement container-specific AI instructions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HJARNI_UPDATE_NOTEUpdate note metadata, placement, tags, or body. body replaces the entire Markdown body; append_body safely appends text. Provide expected_lock_version from GET_NOTE to prevent overwriting concurrent edits.

Input Parameters

string
Complete replacement Markdown body; mutually exclusive with append_body.
string
Replacement title.
integer
required
ID of the note to update.
string
Replacement summary.
integer
Replacement position within the note’s scope.
array
Complete replacement tag-name list. An empty list removes all tags; omission leaves tags unchanged.
string
Replacement source URL.
string
Markdown text to append; mutually exclusive with body.
integer
Move to this container. Explicit null moves the note to inbox; omission leaves placement unchanged.
integer
Current lock_version from GET_NOTE. A stale value returns a conflict instead of overwriting a concurrent edit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not