> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hjarni

> Hjarni is a personal knowledge management platform for organizing, searching, linking, and maintaining notes, containers, and tags.

![Hjarni logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/hjarni.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=d60565a2d32841b053a2310005737d9e)

* **Category:** notes
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `HJARNI`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Container
>
> **Slug:** `HJARNI_CREATE_CONTAINER`
>
> Create a root or nested Hjarni container for organizing notes.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Container name.
>
> **position** `integer`
>
> Optional order position among sibling containers.
>
> **parent\_id** `integer`
>
> Parent container ID; omit to create a root container.
>
> **description** `string`
>
> Optional container description.
>
> **llm\_instructions** `string`
>
> Optional AI instructions scoped to this container.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Note
>
> **Slug:** `HJARNI_CREATE_NOTE`
>
> Create 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
>
> **body** `string`
>
> Markdown note body.
>
> **title** `string` *required*
>
> Note title.
>
> **summary** `string`
>
> Optional note summary.
>
> **position** `integer`
>
> Optional position within the destination scope.
>
> **tag\_names** `array`
>
> Tag names to apply to the note.
>
> **source\_url** `string`
>
> Optional URL from which the note content originated.
>
> **container\_id** `integer`
>
> Destination container ID; omit to create the note in the inbox.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Notes
>
> **Slug:** `HJARNI_CREATE_NOTES`
>
> Create 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
>
> **notes** `array` *required*
>
> Notes to create in order (1-25). The batch is non-atomic: successful notes remain created if another item fails.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tag
>
> **Slug:** `HJARNI_CREATE_TAG`
>
> Create a Hjarni tag for organizing notes.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Non-blank tag name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Status
>
> **Slug:** `HJARNI_GET_ACCOUNT_STATUS`
>
> Return 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Note
>
> **Slug:** `HJARNI_GET_NOTE`
>
> Get one Hjarni note by ID with its Markdown body, tags, container, attachments, links, and optimistic-lock version.
>
> #### Input Parameters
>
> **note\_id** `integer` *required*
>
> ID of the note to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Containers
>
> **Slug:** `HJARNI_LIST_CONTAINERS`
>
> List 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
>
> **scope** `string ("archived" | "all")`
>
> Container subset: omit for active roots, archived for archived roots, or all for all active containers in a flat view.
>
> **per\_page** `integer`
>
> Maximum containers in this page (1-100).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Notes
>
> **Slug:** `HJARNI_LIST_NOTES`
>
> List 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
>
> **tag** `string`
>
> Only return notes carrying this tag name.
>
> **query** `string`
>
> Optional text filter for personal notes.
>
> **scope** `string ("archived" | "inbox" | "favorited")`
>
> Optional note subset; omit for active notes.
>
> **per\_page** `integer`
>
> Maximum notes in this page (1-100).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **container\_id** `integer`
>
> Only return notes directly in this container.
>
> **exclude\_body** `boolean`
>
> Omit note bodies to reduce response size; set false when bodies are needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `HJARNI_LIST_TAGS`
>
> List all Hjarni tags and their note counts. Use next\_cursor to page through results.
>
> #### Input Parameters
>
> **per\_page** `integer`
>
> Maximum tags in this page (1-100).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Trashed Notes
>
> **Slug:** `HJARNI_LIST_TRASHED_NOTES`
>
> List recoverable trashed Hjarni notes with their deletion and scheduled purge times. Use next\_cursor to page through results.
>
> #### Input Parameters
>
> **per\_page** `integer`
>
> Maximum trashed notes in this page (1-100).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rename Tag
>
> **Slug:** `HJARNI_RENAME_TAG`
>
> Rename an existing Hjarni tag without changing its note associations.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New non-blank tag name.
>
> **tag\_id** `integer` *required*
>
> ID of the tag to rename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore Note
>
> **Slug:** `HJARNI_RESTORE_NOTE`
>
> Restore 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
>
> **note\_id** `integer` *required*
>
> ID of the trashed note to restore.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Note to Trash
>
> **Slug:** `HJARNI_TRASH_NOTE`
>
> Move 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
>
> **note\_id** `integer` *required*
>
> ID of the note to move to recoverable Trash.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Container
>
> **Slug:** `HJARNI_UPDATE_CONTAINER`
>
> Update a Hjarni container's name, description, parent, position, or container-specific AI instructions.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement name.
>
> **position** `integer`
>
> Replacement order position among sibling containers.
>
> **parent\_id** `integer`
>
> Move under this parent. Explicit null moves the container to the root; omission leaves the parent unchanged.
>
> **description** `string`
>
> Replacement description.
>
> **container\_id** `integer` *required*
>
> ID of the container to update.
>
> **llm\_instructions** `string`
>
> Replacement container-specific AI instructions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Note
>
> **Slug:** `HJARNI_UPDATE_NOTE`
>
> Update 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
>
> **body** `string`
>
> Complete replacement Markdown body; mutually exclusive with append\_body.
>
> **title** `string`
>
> Replacement title.
>
> **note\_id** `integer` *required*
>
> ID of the note to update.
>
> **summary** `string`
>
> Replacement summary.
>
> **position** `integer`
>
> Replacement position within the note's scope.
>
> **tag\_names** `array`
>
> Complete replacement tag-name list. An empty list removes all tags; omission leaves tags unchanged.
>
> **source\_url** `string`
>
> Replacement source URL.
>
> **append\_body** `string`
>
> Markdown text to append; mutually exclusive with body.
>
> **container\_id** `integer`
>
> Move to this container. Explicit null moves the note to inbox; omission leaves placement unchanged.
>
> **expected\_lock\_version** `integer`
>
> Current lock\_version from GET\_NOTE. A stale value returns a conflict instead of overwriting a concurrent edit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
