Axiomatic Docs

Collaborate with your team using threaded comments, @mentions, and emoji reactions on financial records.

Overview

Axiomatic supports team collaboration directly on financial records. You can leave comments on journal entries, events, and other records, @mention teammates to get their attention, and react with emojis. All collaboration activity is integrated with the notification system for real-time alerts.

Comments

Threaded Discussions

Comments can be left on any supported record type:

Target Type	Description
`journal_entry`	Comment on a journal entry to discuss postings, request changes, or document decisions
`event`	Comment on an event to discuss classification, amounts, or source data
`period`	Comment on an accounting period to coordinate close activities
`document`	Comment on an uploaded document to discuss contents or request re-upload

Comments support threaded replies — click "Reply" on any comment to start a nested conversation.

@Mentions

Type @ in a comment to see an autocomplete list of team members who have access to the current entity. Selecting a team member inserts their name and triggers a mention notification so they're immediately alerted.

Mentioned users receive both an in-app notification and (if enabled) an email notification with the comment text and a link to the record.

Emoji Reactions

React to any comment with an emoji. Click the reaction button on a comment to add or remove your reaction. Reactions are toggled — clicking the same emoji again removes it.

Notifications

Team collaboration is fully integrated with the notification system:

Action	Notification Type	Recipients
New comment on a record	`comment_added`	Other participants on the record
@mention in a comment	`mention`	The mentioned user

Editing and Deleting

Edit: You can edit the body of your own comments after posting
Delete: You can soft-delete your own comments. Deleted comments show as "[deleted]" to preserve thread context

Only the comment author can edit or delete their comments.

API Reference

List Comments

GET /api/comments?targetType=journal_entry&targetId=entry-uuid

Returns all comments for a specific record, including nested replies and reactions.

Create Comment

POST /api/comments
{
  "targetType": "journal_entry",
  "targetId": "entry-uuid",
  "body": "Looks good, but @sarah should double-check the FX rate used here.",
  "parentId": null
}

The parentId field is optional — set it to create a threaded reply to an existing comment.

@mentions are automatically parsed from the comment body. Mentioned users receive notifications.

Update Comment

PATCH /api/comments/:id
{
  "body": "Updated comment text"
}

Delete Comment

DELETE /api/comments/:id

Soft-deletes the comment (sets deletedAt timestamp).

Toggle Reaction

POST /api/comments/:id/reactions
{
  "emoji": "👍"
}

Adds the reaction if not present, removes it if already present (toggle behavior).

Team Collaboration