Dovetail

Dovetail Summarize API

The Summarize API from Dovetail — 1 operation(s) for summarize.

GitHub OpenAPI

Operations 1

POST /v1/summarize Magic Summarize #

Documentation

📖
Documentation
https://developers.dovetail.com/docs/introduction
📖
APIReference
https://developers.dovetail.com/reference
📖
GettingStarted
https://developers.dovetail.com/docs/introduction
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/authentication/dovetail-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/rate-limits/dovetail-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/openapi/dovetail-summarize-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/conventions/dovetail-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/errors/dovetail-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/data-model/dovetail-data-model.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/lifecycle/dovetail-lifecycle.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/llms/dovetail-llms.txt

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dovetail:dovetail-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dovetail-summarize-api-openapi.yml Raw ↑ 
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.
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-14'
  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