Dovetailapp Datasets API
The Datasets API from Dovetailapp — 1 operation(s) for datasets.
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:dovetailapp-datasets-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 Datasets 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: Datasets
paths:
/v1/dataset/{dataset_id}/data:
post:
description: 'Send a new data point to a dataset, without it having to belong to a channel.
A dataset is one connection under a source — the same thing shown as a dataset in the Dovetail UI. Sending data here lets a push-based source (such as the API or Zapier) ingest before any channel subscribes to it. Field values are captured against the source as the data arrives, so once a channel does subscribe, the data is already filterable.
No `url` is returned. Until a channel subscribes to the source, the data point has no page in Dovetail to link to.
> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you''re making updates.'
summary: Create data point on a dataset
tags:
- Datasets
parameters:
- name: dataset_id
in: path
required: true
schema:
type: string
description: Unique identifier of the dataset, shown as a dataset under its source in Dovetail. Accepts the short form shown in the UI or the plain uuid.
requestBody:
description: Body
content:
application/json:
schema:
type: object
properties:
text:
type: string
minLength: 1
maxLength: 5000000
description: The data point's content, used to analyze and classify the data point.
example: Support email requesting a trial for Dovetail app.
timestamp:
type: string
description: The data point's timestamp in ISO8601 format.
source_title:
type: string
minLength: 1
maxLength: 500
description: The title of the original source from which this data point was extracted.
source_url:
type: string
minLength: 1
maxLength: 2000
description: The URL of the original source from which this data point was extracted.
email:
type: string
maxLength: 320
format: email
description: Email of the person this data point is from. When the source creates contacts, the data point is linked to that contact, creating it if needed. Returns 400 if invalid.
example: jane@example.com
metadata:
type: object
additionalProperties:
oneOf:
- type: string
maxLength: 100
- type: number
- type: boolean
- type: array
items:
type: string
maxLength: 100
- type:
- string
- 'null'
format: 'null'
description: Optional key-value metadata to be included with the data point.
required:
- text
- timestamp
responses:
'201':
description: '201'
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
type: string
description: Unique identifier of the data point.
dataset:
type: object
properties:
id:
type: string
description: Unique identifier of the dataset.
required:
- id
timestamp:
type: string
description: The data point's timestamp in ISO8601 format.
created_at:
type: string
description: When the data point was created, in ISO8601 format.
required:
- id
- dataset
- timestamp
- created_at
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: object
properties:
code:
type: string
enum:
- InternalError
title:
type: string
enum:
- Internal server error
message:
type: string
required:
- code
- title
required:
- errors
operationId: postV1DatasetByDatasetIdData
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-24'
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