catetin_accept_group_invitation
ChatGPTJoin a catetin.ai group by accepting an invitation addressed to the user's own email. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.
catetin_cancel_group_invitation
ChatGPTCancel a pending catetin.ai group invitation. Group owners and admins can cancel invitations their group sent; users can decline invitations addressed to them. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.
catetin_change_group_member_role
ChatGPTMake a catetin.ai group member an admin or a regular member. Requires group owner or admin. The owner's role cannot be changed, and users cannot change their own role. Call first with confirmed=false for a preview, then call again with confirmed=true after the user explicitly confirms.
catetin_commit_transaction_draft
ChatGPTCommit a prepared transaction draft after explicit user confirmation. Requires a unique idempotency key.
catetin_create_category
ChatGPTCreate a transaction category in a catetin.ai group. Only call when the user asked for it. Counts toward the group owner's category quota. Requires a unique idempotency key.
catetin_create_group
ChatGPTCreate a catetin.ai group owned by the user, with starting categories from a template. Only call when the user asked for it. Counts toward the user's group quota. Requires a unique idempotency key.
catetin_delete_category
ChatGPTDelete an unused transaction category from a catetin.ai group. Categories that still have transactions cannot be deleted. Call first with confirmed=false to get a preview, then call again with confirmed=true after the user explicitly confirms.
catetin_delete_group
ChatGPTDelete a catetin.ai group with all its transactions, categories, and conversation. Only the group owner can do this. Call first with confirmed=false to see what will be deleted, then call again with confirmed=true after the user explicitly confirms.
catetin_get_category
ChatGPTReturn one transaction category from a catetin.ai group, including its budget target.
catetin_get_dashboard
ChatGPTReturn 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_export_status
ChatGPTReturn 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_financial_summary
ChatGPTReturn income, expense, balance, and category breakdown for a group and date range.
catetin_get_group
ChatGPTReturn a catetin.ai group the user belongs to, including the user's role in it.
catetin_get_group_invitation
ChatGPTReturn one pending catetin.ai group invitation addressed to the user, or sent by a group the user administers.
catetin_get_income_expense_breakdown
ChatGPTReturn 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_profile
ChatGPTReturn the authenticated user's catetin.ai profile: name, email, whether a photo is set, and preferred language.
catetin_get_quota_top_up_balance
ChatGPTReturn the remaining quota top-up balance for the user, or for the owner of a catetin.ai group the user belongs to.
catetin_get_subscription
ChatGPTReturn 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_usage
ChatGPTReturn the authenticated user's catetin.ai subscription usage and quota counters.
catetin_get_transaction
ChatGPTReturn one transaction from a catetin.ai group, including updated_at for catetin_move_transaction.
catetin_invite_group_member
ChatGPTInvite 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_leave_group
ChatGPTLeave 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_list_category_templates
ChatGPTList the categories in a catetin.ai category template, as used when creating a group.
catetin_list_group_invitations
ChatGPTList 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_members
ChatGPTList members of a catetin.ai group the user belongs to. Pending invitations are included only for group owners and admins.
catetin_list_group_messages
ChatGPTList 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_groups
ChatGPTList groups the authenticated catetin.ai user can access.
catetin_list_quota_top_up_products
ChatGPTList catetin.ai quota top-up packs and the extra chats, receipt scans, voice notes, and exports each one adds.
catetin_list_subscription_products
ChatGPTList catetin.ai plans and the limits each one includes, such as chats, receipt scans, voice notes, exports, groups, and members.
catetin_list_transaction_categories
ChatGPTList transaction categories for a group. Use this before creating or updating transactions.
catetin_move_transaction
ChatGPTMove 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_prepare_create_transaction
ChatGPTPrepare a transaction creation draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.
catetin_prepare_delete_transaction
ChatGPTPrepare a transaction deletion draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.
catetin_prepare_update_transaction
ChatGPTPrepare a transaction update draft. This does not change the ledger until catetin_commit_transaction_draft is called after user confirmation.
catetin_record_external_chat_turn
ChatGPTSave 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_remove_group_member
ChatGPTRemove 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_request_export
ChatGPTStart 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_scan_receipt
ChatGPTRead 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_voice_transaction
ChatGPTTranscribe 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_search_transactions
ChatGPTSearch and list transactions in a group by date range, category, or text.
catetin_send_group_message
ChatGPTSend 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_update_category
ChatGPTUpdate 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_group
ChatGPTUpdate 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_preferences
ChatGPTSet the user's preferred catetin.ai language. Group settings such as timezone, currency, and spending alerts are changed with catetin_update_group.
catetin_update_profile
ChatGPTChange 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.