github-starred/actual
2
0
Fork 0
mirror of https://github.com/actualbudget/actual.git synced 2026-03-09 11:42:54 -05:00
Code Issues 250 Packages Projects Releases 53 Wiki Activity

[PR #7096] [WIP] [AI] Correct API docs to match actual implementation #6938

New Issue
Open
opened 2026-02-28 21:34:37 -06:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-02-28 21:34:37 -06:00
Owner
Copy Link

Original Pull Request: https://github.com/actualbudget/actual/pull/7096

State: open
Merged: No

Description

The API reference documentation was wrong about several method signatures. I found these while building Actual Budget agent skills and comparing the docs to the actual implementation in packages/api/methods.ts.

Fixes:

  • updateRule takes the full rule object, not (id, fields) like other update methods
  • getPayeeRules returns Rule[], not PayeeRule[]
  • createSchedule, init, runImport, batchBudgetUpdates had unnecessary nesting in the docs - their arguments are actually flat
  • getCommonPayees wasn't documented at all

Related issue(s)

None - found this while working with the API directly.

Testing

Compared every signature change against the actual implementation in packages/api/methods.ts. Docs only, no code changes.

Checklist

  • Release notes added
  • No regressions (docs change)
  • Self-reviewed
**Original Pull Request:** https://github.com/actualbudget/actual/pull/7096 **State:** open **Merged:** No --- <!-- Thank you for submitting a pull request! Make sure to follow the instructions to write release notes for your PR — it should only take a minute or two: https://github.com/actualbudget/docs#writing-good-release-notes. Try running yarn generate:release-notes *before* pushing your PR for an interactive experience. --> ## Description The API reference documentation was wrong about several method signatures. I found these while building [Actual Budget agent skills](https://github.com/tifandotme/dotfiles/tree/master/dot_agents/skills) and comparing the docs to the actual implementation in `packages/api/methods.ts`. Fixes: - `updateRule` takes the full rule object, not `(id, fields)` like other update methods - `getPayeeRules` returns `Rule[]`, not `PayeeRule[]` - `createSchedule`, `init`, `runImport`, `batchBudgetUpdates` had unnecessary nesting in the docs - their arguments are actually flat - `getCommonPayees` wasn't documented at all ## Related issue(s) None - found this while working with the API directly. ## Testing Compared every signature change against the actual implementation in `packages/api/methods.ts`. Docs only, no code changes. ## Checklist - [x] Release notes added - [x] No regressions (docs change) - [x] Self-reviewed <!--- actual-bot-sections --->
GiteaMirror added the pull-request label 2026-02-28 21:34:37 -06:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
AI generated
API
bank sync
budgeting
bug
can’t replicate
dependencies
docker
documentation
electron
experimental feature
feature
feedback
goal templates
good first issue
help wanted
importers
maintenance
needs info
needs testing
needs triage
needs votes
openid
payees
pull-request
Mirrored from GitHub Pull Request
 regression
reports
responsive
rules
schedules
server
✨ merged
split transactions
tech debt
theme
transaction import
transaction reconciliation
transactions
translations
upstream
user interface
✅ approved
wontfix
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#6938
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?