x as the password, and it can see every project in the organization.
Tasks have two ids: the global id that every task route takes, and local_task_id, the #number shown in the BugHerd UI. Use tasks.showByLocalId to turn a #number into a task, and tasks.move takes #numbers. A task’s status is its column name (backlog, todo, doing, done, closed or a custom column); a task with no status sits in the Feedback panel.
Lists return up to 100 records per page; pass page to get the next one. An empty list means there are no more. BugHerd allows 60 requests a minute.
Risk. Deletes (projects, tasks, columns, attachments, webhooks) cannot be undone, and projects.addGuest with an email sends that person an invitation, so these are destructive. Projects come back without the project’s widget api_key, which lets anyone post feedback into the project.
What you get:
- 39 typed API operations
- 8 synced entities (
attachments,columns,comments,organization,projects,tasks, and 2 more) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the BugHerd API key before the first call: More: API Key
pnpm corsair setup --plugin=bugherd --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
Open tasks in a projectQuery synced data
Synced entities supporttenant.bugherd.db.<entity>.search() and .list(): attachments, columns, comments, organization, projects, tasks, users, webhooks.
See Database for filters and operators.
What’s next
API reference
Every
bugherd.api.* operation with input and output types.Database
Synced entities, search filters, and operators.
Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.