code of ERROR_*, so the plugin treats that as a
failed call rather than returning it as data.
Item and user writes need names the organization defines. Read them first
with organization.itemTypes, organization.userTypes and
organization.lifecycleStatus. items.filter takes itemType as an array;
a bare string is rejected.
A white-label or self-hosted account sets the host option; it defaults to
https://app.onedesk.com.
The public API needs a OneDesk enterprise account, and each API key
consumes one user license.
What you get:
- 79 typed API operations
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 OneDesk API key before the first call: More: API Key
pnpm corsair setup --plugin=onedesk --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
List work items with their detailsWhat’s next
API reference
Every
onedesk.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.