Dovetail

Dovetail Workspace API

The Workspace API from Dovetail — 2 operation(s) for workspace.

GitHub OpenAPI

Operations 2

GET /v1/workspace/context Get workspace context #
POST /v1/workspace/context/docs Add workspace context doc #

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-workspace-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-workspace-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-workspace-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dovetail Public Workspace 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: Workspace
paths:
  /v1/workspace/context:
    get:
      description: 'Retrieve the AI context for the workspace: linked insight docs used as source material for workspace-wide AI features.'
      summary: Get workspace context
      tags:
      - Workspace
      parameters: []
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      docs:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the doc.
                            type:
                              type: string
                              enum:
                              - doc
                          required:
                          - id
                          - type
                    required:
                    - docs
                required:
                - data
        '400':
          description: '400'
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      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: getV1WorkspaceContext
      x-operation-id-source: derived
  /v1/workspace/context/docs:
    post:
      description: 'Add an insight to the workspace''s AI context. A workspace can have at most 10 context docs. If the insight is already linked, this is a no-op.


        Requires a workspace administrator.


        Returns the full updated list of context docs.


        > 🚧 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: Add workspace context doc
      tags:
      - Workspace
      parameters: []
      requestBody:
        description: Body
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  description: Unique identifier of the doc to add to the workspace's AI context.
                  example: 1A2B3C4D5E6F7G8H9I0J1K
              required:
              - id
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier of the doc.
                        type:
                          type: string
                          enum:
                          - doc
                      required:
                      - id
                      - type
                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: postV1WorkspaceContextDocs
      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