Skip to main content
Use BugHerd through Corsair: one client, typed API calls, local DB sync. The BugHerd API v2 authenticates with your organization’s API key (Settings > organization > Authentication Token). It is sent as HTTP Basic with the key as the username and 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
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

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 project
Move a task to Doing and assign it
See the full list on the API page.

Query synced data

Synced entities support tenant.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.