---
title: "API | Annsa Docs"
product: annsa
url: /docs/api
canonical_url: "https://annsa.ai/docs/api"
last_updated: 2026-11-10
type: doc
related:
  - /planning
summary: Send feedback and transcripts into Annsa from your own systems, with the endpoints, fields and limits. Agents use MCP instead.
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# API | Annsa Docs

> Send feedback and transcripts into Annsa from your own systems, with the endpoints, fields and limits. Agents use MCP instead.

[Docs / Choose what to build](https://annsa.ai/docs)

Send feedback in from support tools, CRMs and in-app forms. For agents, use MCP.

## 01 Which door to use

A script, form or internal tool sends feedback with `POST https://api.annsa.ai/surface/submit` and your survey API key. A coding agent uses the [MCP server](https://annsa.ai/docs/using-with-coding-tools) at `https://app.annsa.ai/mcp`. Annsa has no general-purpose REST key.

## 02 Send one item

Take your survey API key from **Settings**, then **Surveys**, and send it in the JSON body as `api_key`, not as a header.

```
{
  "api_key": "YOUR_SURVEY_KEY",
  "text": "The export keeps timing out on large boards",
  "email": "sam@acme.com"
}
```

`text` is the feedback. `email` lets Annsa draft a note when you ship. `feedback_type` (`bug`, `feature`, `question` or `other`) is optional. Annsa also reads the intent from the text. To set name and revenue, import a CSV. See [Importing feedback](https://annsa.ai/docs/importing-feedback).

## 03 Duplicates and limits

The same text twice is one item. A new item returns `{ "id": "..." }`. A duplicate returns its `id` and `"duplicate": true`. Survey submissions are limited to 5,000 an hour. Past your plan's monthly limit, items are held, not dropped. See [Held feedback](https://annsa.ai/docs/held-feedback).

## 04 Send a transcript

`POST https://api.annsa.ai/transcripts/upload` with `text` (50 to 500,000 characters) and `title` (1 to 500 characters). Without a title you get a 422. `customer_email` lets Annsa draft a note when you ship. Annsa recognizes a repeat upload and doesn't add it again. An agent credential is refused for transcript upload.

## 05 The full spec

Every endpoint is in an OpenAPI 3.1 document at [annsa.ai/openapi.json](https://annsa.ai/openapi.json), including which credential each accepts.

- [Importing feedback](https://annsa.ai/docs/importing-feedback)

## Keep reading

- [Connect your agents and sources](https://annsa.ai/guides/mcp-server-for-product-management)
- [AI project management](https://annsa.ai/planning)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [AI project management: the plan agents read first](https://annsa.ai/planning)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact