catetin.ai

Return the catetin.ai dashboard for a group and period: totals, savings, chart points, category targets, and the stored AI insight in the requested language when one is available.

catetin_get_dashboard

Return the status of the user's own catetin.ai export job. When the export is DONE it includes a private, single-use download link that expires after about 10 minutes; share it only with the user, and call again for a fresh link.

catetin_get_export_status

Return a catetin.ai group the user belongs to, including the user's role in it.

catetin_get_group

Return one pending catetin.ai group invitation addressed to the user, or sent by a group the user administers.

catetin_get_group_invitation

Return the authenticated user's catetin.ai profile: name, email, whether a photo is set, and preferred language.

catetin_get_profile

Return the user's current catetin.ai subscription plan, status, renewal dates, and plan limits. Use catetin_get_subscription_usage for current usage.

catetin_get_subscription

Return one transaction from a catetin.ai group, including updated_at for catetin_move_transaction.

catetin_get_transaction

Return per-category income and expense amounts, shares, icons, and budget targets for a catetin.ai group and date range. Use catetin_get_financial_summary for totals and balance.

catetin_get_income_expense_breakdown

Invite someone by email to a catetin.ai group. Requires group owner or admin. catetin.ai sends an invitation email to that address, and the invitation counts toward the group owner's member quota. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms. Requires a unique idempotency key.

catetin_invite_group_member

Leave a catetin.ai group. The owner cannot leave their own group. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.

catetin_leave_group

List transaction categories for a group. Use this before creating or updating transactions.

catetin_list_transaction_categories

List the categories in a catetin.ai category template, as used when creating a group.

catetin_list_category_templates

List pending catetin.ai group invitations, either sent by a group (owner or admin only) or addressed to the user's own email (mine=true).

catetin_list_group_invitations

List members of a catetin.ai group the user belongs to. Pending invitations are included only for group owners and admins.

catetin_list_group_members

List recent messages in a catetin.ai group conversation, newest page first, in chronological order. Image and voice attachments are summarized as text; links are not returned.

catetin_list_group_messages

List groups the authenticated catetin.ai user can access.

catetin_list_groups

List catetin.ai quota top-up packs and the extra chats, receipt scans, voice notes, and exports each one adds.

catetin_list_quota_top_up_products

List catetin.ai plans and the limits each one includes, such as chats, receipt scans, voice notes, exports, groups, and members.

catetin_list_subscription_products

Move a transaction to another catetin.ai group the user belongs to. Call first with confirmed=false to get a preview, show it to the user, then call again with confirmed=true after they explicitly confirm. Both groups must use the same currency and the destination category must have the same type. Requires a unique idempotency key and the expected_updated_at value from catetin_get_transaction.

catetin_move_transaction

Prepare a transaction creation draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.

catetin_prepare_create_transaction

Prepare a transaction deletion draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.

catetin_prepare_delete_transaction

Prepare a transaction update draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.

catetin_prepare_update_transaction

Return the remaining quota top-up balance for the user, or for the owner of a catetin.ai group the user belongs to.

catetin_get_quota_top_up_balance

Save a user-approved message and assistant response to the selected catetin.ai group conversation. Only call when the user explicitly requests or approves saving this conversation turn. Records the transcript and applicable subscription usage without generating a new response.

catetin_record_external_chat_turn

Remove a member from a catetin.ai group. Requires group owner or admin; only the owner can remove admins, and the owner cannot be removed. Use catetin_leave_group to leave yourself. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.

catetin_remove_group_member

Start an Excel or PDF export of a catetin.ai group's transactions for a period. Processing is asynchronous; poll catetin_get_export_status with the returned job_id. Uses one export from the user's quota. Requires a unique idempotency key.

catetin_request_export

Read a receipt image with catetin.ai's AI and return a transaction draft (amount, date, name, suggested category). catetin.ai uploads the image to its storage and uses one receipt scan and one chat from the user's quota. Nothing is saved to the ledger: review the draft with the user, then use catetin_prepare_create_transaction. Call first with confirmed=false, then with confirmed=true after the user agrees. Requires a unique idempotency key.

catetin_scan_receipt

Transcribe a voice note with catetin.ai's AI and return a transaction draft (amount, date, name, suggested category). catetin.ai uploads the audio to its storage and uses one voice note and one chat from the user's quota. Nothing is saved to the ledger or the group conversation: review the draft with the user, then use catetin_prepare_create_transaction. Call first with confirmed=false, then with confirmed=true after the user agrees. Requires a unique idempotency key.

catetin_scan_voice_transaction

Search and list transactions in a group by date range, category, or text.

catetin_search_transactions

Send a message as the user to a catetin.ai group conversation, optionally with an image. Other group members are notified, and catetin.ai's AI replies asynchronously (read the reply later with catetin_list_group_messages). Uses one chat from the user's quota, plus one receipt scan when an image is attached; images are uploaded to catetin.ai storage. Call first with confirmed=false, then with confirmed=true after the user confirms. Requires a unique idempotency key.

catetin_send_group_message

Return the authenticated user's catetin.ai subscription usage and quota counters.

catetin_get_subscription_usage

Update a transaction category in a catetin.ai group; omitted fields keep their current value. Call first with confirmed=false to get a before/after preview, then call again with confirmed=true after the user explicitly confirms.

catetin_update_category

Update a catetin.ai group's name, timezone, currency, or spending alert threshold. Requires group owner or admin. Call first with confirmed=false for a before/after preview, then call again with confirmed=true after the user explicitly confirms.

catetin_update_group

Set the user's preferred catetin.ai language. Group settings such as timezone, currency, and spending alerts are changed with catetin_update_group.

catetin_update_preferences

Change the user's catetin.ai display name and/or profile photo. A new photo is uploaded to catetin.ai storage and replaces the current one. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.

catetin_update_profile