canonical: https://jentic.com/apis/getacute.io/acute

# Getacute Acute API

Jentic publishes the only available OpenAPI specification for Acute API, keeping it validated and agent-ready. Acute is a customer feedback management tool that helps SaaS teams capture, organise, and triage user-submitted feedback alongside Intercom conversations and GitHub issues. The API exposes feedback cards and conversations for retrieval and provides Intercom and GitHub integration helpers, so external automations can read feedback and link it to engineering tickets. It is most often used to push Acute feedback into a data warehouse or a roadmap tool.

## For AI agents

Read user feedback cards and conversations from Acute, and link feedback to GitHub issues or Intercom tags so product and support teams can triage signal automatically.

## Scope

Does not handle public feedback voting, in-app widget delivery, or roadmap publishing - use for reading feedback cards and linking them to GitHub or Intercom only.

## Capabilities

- Retrieve all feedback cards captured in Acute and forward them to a roadmap or data warehouse
- List feedback conversations to triage open user discussions in bulk
- Generate an Intercom tag from an Acute card so support agents can route the conversation
- Link a GitHub issue to an Acute feedback card so engineering can track the request
- Sync customer feedback into product analytics for prioritisation

## Use cases

### Feedback-to-GitHub Linking

Product teams want every piece of upvoted user feedback to map to an engineering ticket so progress is traceable. The Acute API lets a workflow create a GitHub issue from a feedback card, then link the issue back to the card so the loop is closed when the issue ships. This eliminates manual copy-paste between Acute and GitHub.

Example prompt: For a feedback card with the highest vote count this week, call `POST /zapier/cards/add-github-issue` with the issue URL and confirm the link is recorded.

### Feedback Triage in Intercom

Support teams using Intercom want to tag conversations that originated from Acute feedback so they can be routed to the right team. The API generates an Intercom tag for an Acute card, allowing automation to apply consistent labels across both tools and reducing duplicate triage work.

Example prompt: Call `POST /intercom/cards/create-tag` for each new feedback card and apply the returned tag to the linked Intercom conversation.

### Feedback Data Warehouse Export

Analytics teams need feedback in their warehouse alongside product usage data so they can correlate complaints with churn or feature adoption. The Acute API exposes cards and conversations in a structured form, so a scheduled job can pull all records and load them into a destination like BigQuery or Snowflake without scraping the UI.

Example prompt: Call `GET /zapier/cards` and `GET /zapier/conversations`, normalise the records, and load them into a warehouse table partitioned by created date.

### Agent-Driven Feedback Reporting

An AI agent embedded in a product manager's workspace can answer 'what are users asking for this week?' by pulling Acute cards through Jentic and summarising them. The agent uses Jentic to discover the cards endpoint, calls it without handling the bearer token directly, and produces a ranked list of themes.

Example prompt: Pull all feedback cards via Jentic's Acute integration, group by theme, and return a top-10 list with vote counts.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /zapier/cards | Retrieve all feedback cards |
| GET | /zapier/conversations | Retrieve all feedback conversations |
| POST | /zapier/cards/add-github-issue | Link a GitHub issue to a feedback card |
| POST | /intercom/cards/create-tag | Generate an Intercom tag for a feedback card |

## Key resources

- **Cards** — Feedback cards submitted by users; supports listing and integration tagging.
- **Conversations** — Feedback conversations and threads attached to cards.
- **Integrations** — Cross-tool helpers for Intercom tagging and GitHub issue linking.

## Why Jentic

- **Setup:** Wiring the Acute API by hand means setting up its bearer token, attaching the Authorization header on every call, and routing card, conversation, and integration calls to the right paths yourself. Through Jentic you install once, import Acute from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Acute's operations like /zapier/cards/add-github-issue and /intercom/cards/create-tag take their target in the request body rather than the URL path, so scope the agent to the operations it needs, such as reading feedback cards and linking them to a GitHub issue. You choose the operations it may call, so actions like creating an Intercom tag are not included unless you add them.
- **Credential handling:** Your Acute 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 'list customer feedback cards' or 'link feedback to a GitHub issue', and Jentic returns the matching Acute operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Canny** — Customer feedback and roadmap platform with public boards and richer voting workflows.
- **Pendo Feedback** — Feedback module within the Pendo product analytics platform.
- **Freshdesk** — Helpdesk and ticketing platform commonly paired with feedback tools to convert support tickets into product input.

## FAQ

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

Acute does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Acute 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 Acute API use?

The Acute API uses HTTP Bearer authentication. Through Jentic, the bearer token is stored encrypted and injected at execution time - agents do not see the raw token.

### Can I link a GitHub issue to a feedback card with the Acute API?

Yes. Call `POST /zapier/cards/add-github-issue` with the card identifier and GitHub issue URL to attach the issue to the card.

### Can I list all feedback conversations through the Acute API?

Yes. Call `GET /zapier/conversations` to retrieve all feedback conversations. The endpoint returns conversation records suitable for export or triage.

### How do I tag an Intercom conversation from an Acute card via Jentic?

Search Jentic for `tag an Intercom conversation from Acute feedback`, load the schema for `POST /intercom/cards/create-tag`, and execute with the card identifier. Jentic handles the bearer token automatically.

### Does the Acute API support submitting new feedback or upvotes?

No. The current API surface is read-oriented for cards and conversations and integration-helper for GitHub and Intercom. New feedback submission and voting happen through the Acute UI or product widget.

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

Yes. Because you run Jentic One yourself, your own rules decide which Acute operations and credentials the agent may use. You can allow it to only read feedback with GET /zapier/cards and GET /zapier/conversations, while withholding write actions like POST /zapier/cards/add-github-issue or POST /intercom/cards/create-tag until you explicitly add them. Since these operations take their target in the request body rather than the path, you scope the agent at the operation level to exactly the calls it needs.