canonical: https://jentic.com/apis/crushthememory.com/crushthememory

# Crushthememory CRUSH API

Jentic publishes the only available OpenAPI specification for CRUSH API, keeping it validated and agent-ready. CRUSH is an AI-assisted note-taking and second-brain product. The API exposes six endpoints: a direct note creation call, a note-flags read, and a small set of Zapier webhook hooks for subscribe, unsubscribe, trigger, and create-via-Zapier. Authentication uses a JWT bearer token.

## For AI agents

Create notes in a user's CRUSH second brain and manage Zapier webhook subscriptions for downstream automations.

## Scope

Does not handle full-text note search, sharing permissions, or task management - use for note creation, flag listing, and Zapier webhook plumbing only.

## Capabilities

- Create a new note in the user's CRUSH workspace via POST `/api/aws/notes`
- Retrieve the list of note flags currently set on the workspace
- Subscribe a Zapier integration to CRUSH events for downstream automations
- Unsubscribe a previously registered Zapier webhook
- Send a webhook trigger payload through the Zapier endpoint
- Create a note from a Zapier flow via the dedicated Zapier create endpoint

## Use cases

### Voice-to-Note Capture

Send transcribed voice notes into CRUSH automatically by calling the create-note endpoint after a transcription run completes. Lets users dump thoughts from anywhere without opening the CRUSH app.

Example prompt: After transcribing a voice memo, POST `/api/aws/notes` with the transcript text and a tag identifying the source device.

### Zapier-Driven Inbox to CRUSH

Connect external sources (email, Slack, RSS) into CRUSH by registering a Zapier subscription and pushing each payload through the Zapier create or trigger endpoints. Useful when the source has a Zapier connector but no direct CRUSH integration.

Example prompt: POST `/api/zapier/subscribe` with the Zap target URL, then for each captured event POST `/api/zapier/create` with the payload to land it in CRUSH.

### Flag-Based Note Triage

Pull the list of note flags via GET `/api/aws/noteflags` to drive a triage UI or summary report - for example, surfacing every note flagged 'follow-up' or 'idea' for a weekly review session.

Example prompt: Call GET `/api/aws/noteflags`, group results by flag name, and produce a weekly review document grouped by category.

### Agent-Driven Knowledge Capture

Allow an AI agent to write into the user's CRUSH workspace as part of a longer workflow ('summarise this article and save it', 'capture three ideas from this brainstorm') by routing the note creation through Jentic so the JWT stays in the vault.

Example prompt: Search Jentic for 'capture a note in my second brain', load the create-note operation, and execute it with the article summary.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/aws/notes` | Create a note |
| GET | `/api/aws/noteflags` | Retrieve note flags |
| POST | `/api/zapier/subscribe` | Subscribe a Zapier webhook |
| DELETE | `/api/zapier/subscribe` | Unsubscribe a Zapier webhook |
| POST | `/api/zapier/create` | Create a note via Zapier |
| POST | `/api/zapier/trigger` | Send a Zapier webhook trigger |

## Key resources

- **Notes** — Create new notes and inspect note flags in the user's CRUSH workspace.
- **Zapier** — Subscribe and unsubscribe Zapier webhooks, send triggers, and create notes from Zapier payloads.

## Why Jentic

- **Setup:** Wiring the CRUSH API by hand means setting its JWT bearer auth and threading note creation, flag listing, and Zapier subscribe, create, and trigger calls yourself. Through Jentic you install once, import the CRUSH API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** CRUSH identifies notes and Zapier hooks in the request body rather than the URL path, so limit the agent to the operations it needs, such as creating a note or listing note flags. You choose the operations it may call, so deleting a Zapier subscription is not included unless you add it.
- **Credential handling:** Your CRUSH JWT bearer token is stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'capture a note in my second brain' or 'list note flags', and Jentic returns the matching CRUSH operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Cruise Control API** — Outbound review-request automation that can complement note-driven workflows.
- **Crustdata API** — External data enrichment to attach context to captured notes.
- **Cruisen API** — Travel-advisor data source - included as a corpus-verified neighbour rather than a true alternative.

## FAQ

### Why is there no official OpenAPI spec for CRUSH API?

Crush The Memory does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CRUSH API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the CRUSH API use?

The API uses HTTP bearer authentication with a JWT. Through Jentic the JWT is stored encrypted in the vault and never enters the agent prompt - Jentic injects it into the Authorization header at execution time.

### Can I create a note in CRUSH through the API?

Yes. POST `/api/aws/notes` with the note body creates a new note in the authenticated user's workspace. Alternatively, POST `/api/zapier/create` accepts a Zapier-shaped payload for the same outcome through a Zap.

### How do I subscribe a Zapier webhook to CRUSH events?

POST `/api/zapier/subscribe` with the target URL registers the subscription. Use POST `/api/zapier/trigger` to push events and DELETE `/api/zapier/subscribe` to unregister when the Zap is removed.

### What are the rate limits for the CRUSH API?

The OpenAPI specification does not document specific rate limits. Watch for HTTP 429 responses and contact CRUSH support for production quotas before bulk-importing notes.

### How do I capture a note in CRUSH through Jentic?

Run pip install jentic, search 'capture a note in my second brain', load the create-note operation, and execute it with the note text. Jentic injects the JWT bearer automatically.

### Can I limit what my agent is allowed to do with the CRUSH API?

Yes. Because you run Jentic One yourself, your own rules decide which CRUSH operations and credentials the agent may use. You can allow only the calls the agent needs, such as creating a note with POST `/api/aws/notes` or listing note flags with GET `/api/aws/noteflags`, while withholding the Zapier subscribe, trigger, and create endpoints. Destructive actions like unsubscribing a Zapier webhook with DELETE `/api/zapier/subscribe` stay off unless you explicitly grant them.