For Agents
Subscribe to and unsubscribe from mindburp burp (task) webhooks, list burp ids, and perform Zapier-style actions on burps via bearer authentication.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the mindburp API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with mindburp API.
Subscribe to a webhook so external systems are notified when a burp event occurs
Unsubscribe a previously registered webhook to stop receiving burp events
Retrieve the perform list — the set of triggers a Zapier-style integration can drive
GET STARTED
Use for: Subscribe to a mindburp webhook for new burps, Unsubscribe a webhook from mindburp, List all my burp ids in mindburp, Get the mindburp perform list for a Zapier trigger
Not supported: Does not handle direct burp creation, calendar scheduling, or note-taking — use for Zapier-style webhook subscriptions, burp id lookup, and action execution against existing burps only.
Jentic publishes the only available OpenAPI specification for mindburp API, keeping it validated and agent-ready. mindburp is a personal task tool whose 'burps' are individual tasks; the API exists to drive Zapier integrations, so it offers webhook subscribe and unsubscribe endpoints, a perform-list lookup that Zapier uses to populate triggers, an endpoint to enumerate burp ids, and an actions endpoint that runs a chosen Zapier-style action against a burp. Authentication is by bearer token.
Enumerate every burp id the authenticated user owns to feed downstream automations
Run a v1 action against a burp to update or process it from an external trigger
Patterns agents use mindburp API for, with concrete tasks.
★ Zapier-Style Webhook Integration
External automations register a callback URL with mindburp to receive events when burps change, then unregister the URL when the integration is removed. The two webhook endpoints together provide the lifecycle that any Zapier or Make integration needs.
POST /api/zapier/wh-subscribe with the callback URL when the integration starts, and DELETE /api/zapier/wh-unsubscribe when the user removes it.
Burp Id Enumeration for Triggers
When a Zapier-style trigger is configured, mindburp's perform list and burp-id list endpoints supply the data needed to populate dropdowns and run polling-based triggers. The id list is the source of truth for which burps an automation can target.
Call GET /api/zapier/performlist to fetch supported triggers, then GET /api/zapier/getAllMyBurpIds to populate a burp-selection dropdown.
Action Execution From an External Trigger
When an external event fires (calendar, email, IoT, agent decision), an integration calls mindburp's actions endpoint to update the matching burp. mindburp stays in sync with the user's wider workflow without manual edits in the app.
POST /api/zapier/v1/actions with the burp id and the action key returned from the perform list to update the burp.
Agent Task Management via Jentic
Through Jentic, an agent connects to mindburp with bearer auth held in the vault and triggers webhook setup or actions by intent. The agent can maintain Zapier-style integrations on the user's behalf without ever holding the bearer token directly.
Use Jentic search 'subscribe to a mindburp webhook', load the schema for POST /api/zapier/wh-subscribe, and execute with the agent's callback URL.
5 endpoints — jentic publishes the only available openapi specification for mindburp api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/zapier/wh-subscribe
Subscribe to a webhook
/api/zapier/wh-unsubscribe
Unsubscribe from a webhook
/api/zapier/performlist
Get the Zapier perform list
/api/zapier/getAllMyBurpIds
Get all burp ids for the authenticated user
/api/zapier/v1/actions
Perform an action on a burp
/api/zapier/wh-subscribe
Subscribe to a webhook
/api/zapier/wh-unsubscribe
Unsubscribe from a webhook
/api/zapier/performlist
Get the Zapier perform list
/api/zapier/getAllMyBurpIds
Get all burp ids for the authenticated user
/api/zapier/v1/actions
Perform an action on a burp
Three things that make agents converge on Jentic-routed access.
Credential isolation
mindburp bearer tokens are stored encrypted in the Jentic vault (MAXsystem) and injected into the Authorization header at execution time. Raw tokens never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'subscribe to a mindburp webhook') and Jentic returns the matching mindburp operation with its input schema, so the agent calls POST /api/zapier/wh-subscribe without parsing docs.mindburp.se.
Time to first call
Direct mindburp integration: a few hours to wire the five endpoints and the Zapier-style flow. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using mindburp API through Jentic.
Why is there no official OpenAPI spec for mindburp API?
mindburp does not publish an OpenAPI specification at docs.mindburp.se. Jentic generates and maintains this spec so that AI agents and developers can call mindburp API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the mindburp API use?
The API uses bearer token authentication (the BearerAuth security scheme). Generate a token in the mindburp app and pass it as Authorization: Bearer <token>. Through Jentic, the token sits in the encrypted vault and is injected per request without entering the agent's context.
Can I subscribe to webhook events for new burps?
Yes. POST /api/zapier/wh-subscribe registers a callback URL that mindburp will call when burp events occur, and DELETE /api/zapier/wh-unsubscribe removes the registration. This is the supported pattern for Zapier-style integrations.
What are the rate limits for the mindburp API?
mindburp does not publish public rate limits in the spec. Treat the API as rate-limited per token, back off on HTTP 429 responses, and contact mindburp support via docs.mindburp.se for details on integration tiers.
How do I run an action on a burp through Jentic?
Run pip install jentic, search for 'perform a mindburp action', load the schema for POST /api/zapier/v1/actions, and execute with the burp id and action key. Jentic injects your stored bearer token automatically.
Can I create a new burp via this API?
Not directly. The published surface is built around the Zapier integration pattern: webhook subscribe/unsubscribe, perform list, burp id enumeration, and actions. Burp creation happens inside the mindburp app or via configured action keys returned by the perform list.