Dovetail Summarize API
The Summarize API from Dovetail — 1 operation(s) for summarize.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/dovetailapp-com:dovetailapp-com-summarize-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Dovetail Public Summarize API
version: 0.0.1
description: 'The Dovetail Public API provides programmatic access to your Dovetail workspace.
## Core concepts
- **Projects** — Containers for organizing qualitative research. They hold data, docs, highlights, tags, and insights.
- **Data** — Documents within a project that capture raw research data such as interview transcripts, survey responses, and session recordings. Available via `/v1/data`. The legacy `/v1/notes` endpoints access the same underlying resource.
- **Docs** — Rich-text documents for writing up research reports, sharing findings, and publishing deliverables. Docs replace the deprecated insights resource.
- **Highlights** — Selected passages of text or time ranges in transcripts that have been marked as significant during analysis.
- **Tags** — Labels applied to highlights to categorize findings (e.g. ''Usability Issue'', ''Feature Request'').
- **Channels** — Automated AI-powered pipelines that continuously analyze high-volume customer feedback (app reviews, NPS, support tickets) into structured topics.
- **Contacts** — People in your contacts database such as interview participants or customers.
- **Folders** — Hierarchical containers for organizing projects, docs, channels, and other content.
- **Files** — Attachments (images, documents, audio, video) that can be embedded in docs, data entries, or insights.
## Authentication
All requests require a Bearer token in the `Authorization` header. Generate API tokens from your Dovetail workspace settings.
## Base URL
All API endpoints are served under `https://dovetail.com/api`.'
servers:
- url: https://dovetail.com/api
- url: https://dovetailapp.com/api
security:
- bearerAuth: []
tags:
- name: Summarize
paths:
/v1/summarize:
post:
description: 'Generate an AI-powered summary from a collection of highlights, data entries (notes), insights, themes, and/or tags. Provide one or more arrays of IDs and Dovetail will synthesize the content into a concise summary.
At least one of `highlight_ids`, `note_ids`, `insight_ids`, `theme_ids`, or `tag_ids` must contain at least one item. The `note_ids` field accepts data entry IDs (the product now calls these "data" rather than "notes").
Set `with_citations` to `true` (default) to include citation references in the summary. Each citation links back to the specific source item (highlight, data entry, insight, theme, or tag) that contributed to that part of the summary.
Returns a summary string and an array of citations with their source IDs and types.'
summary: Magic Summarize
tags:
- Summarize
parameters: []
requestBody:
description: Body
content:
application/json:
schema:
type: object
properties:
highlight_ids:
default: []
type: array
items:
type: string
description: A list of unique highlightIds that you wish to summarize.
note_ids:
default: []
type: array
items:
type: string
description: A list of unique noteIds that you wish to summarize.
insight_ids:
default: []
type: array
items:
type: string
description: A list of unique insightIds that you wish to summarize.
theme_ids:
default: []
type: array
items:
type: string
description: A list of unique themeIds that you wish to summarize.
tag_ids:
default: []
type: array
items:
type: string
description: A list of unique tagIds that you wish to summarize.
with_citations:
default: true
type: boolean
description: An optional flag whether to show citations or not, true by default.
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
summary:
type: string
citations:
type: array
items:
type: object
properties:
id:
type: string
type:
type: string
enum:
- HIGHLIGHT
- INSIGHT
- NOTE
- THEME
- TAG
citation_id:
type: number
required:
- id
- type
- citation_id
required:
- summary
- citations
required:
- data
'400':
description: '400'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
oneOf:
- type: object
properties:
code:
type: string
enum:
- InvalidOperation
title:
type: string
message:
type: string
path:
type: string
required:
- code
- title
- type: object
properties:
code:
type: string
enum:
- ValidationError
title:
type: string
enum:
- Contract violation
message:
type: string
path:
type: string
required:
- code
- title
- message
- path
required:
- errors
'401':
description: '401'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- Unauthorized
title:
type: string
message:
type: string
required:
- code
- title
required:
- errors
'403':
description: '403'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
oneOf:
- type: object
properties:
code:
type: string
enum:
- Forbidden
title:
type: string
message:
type: string
required:
- code
- title
- type: object
properties:
code:
type: string
enum:
- IpNotAllowlisted
title:
type: string
message:
type: string
decisionId:
type: string
description: Correlation id quoting this enforcement decision — include it when contacting support.
required:
- code
- title
- decisionId
required:
- errors
'404':
description: '404'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- NotFound
title:
type: string
message:
type: string
required:
- code
- title
required:
- errors
'422':
description: '422'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- UnprocessableContent
title:
type: string
message:
type: string
required:
- code
- title
- message
required:
- errors
'429':
description: '429'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- TooManyRequests
title:
type: string
message:
type: string
required:
- code
- title
required:
- errors
'500':
description: '500'
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- InternalError
title:
type: string
enum:
- Internal server error
message:
type: string
required:
- code
- title
required:
- errors
operationId: postV1Summarize
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
x-provenance:
method: searched
source: https://developers.dovetail.com/reference
harvested: '2026-10-21'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.dovetail.com/reference/delete_v1-channels-channel-id.md
- https://developers.dovetail.com/reference/delete_v1-channels-topic-topic-id.md
- https://developers.dovetail.com/reference/delete_v1-contacts-contact-id.md
- https://developers.dovetail.com/reference/delete_v1-data-data-id.md
- https://developers.dovetail.com/reference/delete_v1-docs-doc-id-comments-comment-id.md
- https://developers.dovetail.com/reference/delete_v1-docs-doc-id.md
- https://developers.dovetail.com/reference/delete_v1-fields-field-id.md
- https://developers.dovetail.com/reference/delete_v1-folders-folder-id.md
- https://developers.dovetail.com/reference/delete_v1-insights-insight-id-comments-comment-id.md
- https://developers.dovetail.com/reference/delete_v1-insights-insight-id.md
- https://developers.dovetail.com/reference/delete_v1-notes-note-id.md
- https://developers.dovetail.com/reference/delete_v1-projects-project-id-context-docs-doc-id.md
- https://developers.dovetail.com/reference/delete_v1-projects-project-id-context-keywords.md
- https://developers.dovetail.com/reference/delete_v1-projects-project-id.md
- https://developers.dovetail.com/reference/get_v1-channels-channel-id-data.md
- https://developers.dovetail.com/reference/get_v1-channels-channel-id-themes.md
- https://developers.dovetail.com/reference/get_v1-channels-channel-id.md
- https://developers.dovetail.com/reference/get_v1-channels-data-datum-id.md
- https://developers.dovetail.com/reference/get_v1-channels.md
- https://developers.dovetail.com/reference/get_v1-contacts-contact-id.md
- https://developers.dovetail.com/reference/get_v1-contacts.md
- https://developers.dovetail.com/reference/get_v1-data-data-id-export-type.md
- https://developers.dovetail.com/reference/get_v1-data-data-id.md
- https://developers.dovetail.com/reference/get_v1-data.md
- https://developers.dovetail.com/reference/get_v1-docs-doc-id-comments-comment-id.md
- https://developers.dovetail.com/reference/get_v1-docs-doc-id-comments.md
- https://developers.dovetail.com/reference/get_v1-docs-doc-id-export-type.md
- https://developers.dovetail.com/reference/get_v1-docs-doc-id.md
- https://developers.dovetail.com/reference/get_v1-docs-user-user-id.md
- https://developers.dovetail.com/reference/get_v1-docs.md
- https://developers.dovetail.com/reference/get_v1-fields-field-id.md
- https://developers.dovetail.com/reference/get_v1-fields.md
- https://developers.dovetail.com/reference/get_v1-files-file-id-download.md
- https://developers.dovetail.com/reference/get_v1-files-file-id.md
- https://developers.dovetail.com/reference/get_v1-folders-folder-id-contents.md
- https://developers.dovetail.com/reference/get_v1-folders-folder-id.md
- https://developers.dovetail.com/reference/get_v1-folders.md
- https://developers.dovetail.com/reference/get_v1-highlights-highlight-id.md
- https://developers.dovetail.com/reference/get_v1-highlights.md
- https://developers.dovetail.com/reference/get_v1-insights-insight-id-comments-comment-id.md
- https://developers.dovetail.com/reference/get_v1-insights-insight-id-comments.md
- https://developers.dovetail.com/reference/get_v1-insights-insight-id-export-type.md
- https://developers.dovetail.com/reference/get_v1-insights-insight-id.md
- https://developers.dovetail.com/reference/get_v1-insights-user-user-id.md
- https://developers.dovetail.com/reference/get_v1-insights.md
- https://developers.dovetail.com/reference/get_v1-notes-note-id-export-type.md
- https://developers.dovetail.com/reference/get_v1-notes-note-id.md
- https://developers.dovetail.com/reference/get_v1-notes.md
- https://developers.dovetail.com/reference/get_v1-projects-project-id-context.md
- https://developers.dovetail.com/reference/get_v1-projects-project-id.md
- https://developers.dovetail.com/reference/get_v1-projects-templates.md
- https://developers.dovetail.com/reference/get_v1-projects.md
- https://developers.dovetail.com/reference/get_v1-tags-boards.md
- https://developers.dovetail.com/reference/get_v1-tags-tag-id.md
- https://developers.dovetail.com/reference/get_v1-tags.md
- https://developers.dovetail.com/reference/get_v1-token-info.md
- https://developers.dovetail.com/reference/get_v1-users-user-id.md
- https://developers.dovetail.com/reference/get_v1-users.md
- https://developers.dovetail.com/reference/get_v1-workspace-context.md
- https://developers.dovetail.com/reference/patch_v1-channels-channel-id.md
- https://developers.dovetail.com/reference/patch_v1-channels-topic-topic-id.md
- https://developers.dovetail.com/reference/patch_v1-contacts-contact-id.md
- https://developers.dovetail.com/reference/patch_v1-data-data-id.md
- https://developers.dovetail.com/reference/patch_v1-docs-doc-id-comments-comment-id.md
- https://developers.dovetail.com/reference/patch_v1-docs-doc-id.md
- https://developers.dovetail.com/reference/patch_v1-fields-field-id.md
- https://developers.dovetail.com/reference/patch_v1-folders-folder-id.md
- https://developers.dovetail.com/reference/patch_v1-insights-insight-id-comments-comment-id.md
- https://developers.dovetail.com/reference/patch_v1-insights-insight-id.md
- https://developers.dovetail.com/reference/patch_v1-notes-note-id.md
- https://developers.dovetail.com/reference/patch_v1-projects-project-id.md
- https://developers.dovetail.com/reference/post_v1-channels-data.md
- https://developers.dovetail.com/reference/post_v1-channels-topic.md
- https://developers.dovetail.com/reference/post_v1-channels.md
- https://developers.dovetail.com/reference/post_v1-contacts.md
- https://developers.dovetail.com/reference/post_v1-data-import-file.md
- https://developers.dovetail.com/reference/post_v1-data.md
- https://developers.dovetail.com/reference/post_v1-dataset-dataset-id-data.md
- https://developers.dovetail.com/reference/post_v1-docs-doc-id-comments-resolve.md
- https://developers.dovetail.com/reference/post_v1-docs-doc-id-comments-unresolve.md
- https://developers.dovetail.com/reference/post_v1-docs-doc-id-comments.md
- https://developers.dovetail.com/reference/post_v1-docs-import-file.md
- https://developers.dovetail.com/reference/post_v1-docs.md
- https://developers.dovetail.com/reference/post_v1-fields.md
- https://developers.dovetail.com/reference/post_v1-files.md
- https://developers.dovetail.com/reference/post_v1-folders.md
- https://developers.dovetail.com/reference/post_v1-highlights-highlight-id-tags.md
- https://developers.dovetail.com/reference/post_v1-highlights.md
- https://developers.dovetail.com/reference/post_v1-insights-import-file.md
- https://developers.dovetail.com/reference/post_v1-insights-insight-id-comments-resolve.md
- https://developers.dovetail.com/reference/post_v1-insights-insight-id-comments-unresolve.md
- https://developers.dovetail.com/reference/post_v1-insights-insight-id-comments.md
- https://developers.dovetail.com/reference/post_v1-insights.md
- https://developers.dovetail.com/reference/post_v1-notes-import-file.md
- https://developers.dovetail.com/reference/post_v1-notes.md
- https://developers.dovetail.com/reference/post_v1-projects-project-id-context-docs.md
- https://developers.dovetail.com/reference/post_v1-projects-project-id-context-keywords.md
- https://developers.dovetail.com/reference/post_v1-projects-project-id-workspace-field-groups.md
- https://developers.dovetail.com/reference/post_v1-projects.md
- https://developers.dovetail.com/reference/post_v1-search.md
- https://developers.dovetail.com/reference/post_v1-summarize.md
- https://developers.dovetail.com/reference/post_v1-tags.md
- https://developers.dovetail.com/reference/post_v1-transcripts-data-id-audio.md
- https://developers.dovetail.com/reference/post_v1-transcripts-data-id-utterance.md
- https://developers.dovetail.com/reference/post_v1-workspace-context-docs.md
- https://developers.dovetail.com/reference/post_v2-files-file-id-large-upload-complete.md
- https://developers.dovetail.com/reference/post_v2-files-file-id-upload-complete.md
- https://developers.dovetail.com/reference/post_v2-files-large-upload.md
- https://developers.dovetail.com/reference/post_v2-files-upload.md
- https://developers.dovetail.com/reference/post_v2-search.md
- https://developers.dovetail.com/reference/put_v1-transcripts-data-id.md
merge:
pages: 111
deduped: 110
conflicts_kept_first: 0