Dovetail

Dovetail Authentication API

The Authentication API from Dovetail — 1 operation(s) for authentication.

GitHub OpenAPI

Operations 1

GET /v1/token/info Token info #

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-authentication-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
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/dovetail/refs/heads/main/apis.yml

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-authentication-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-authentication-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dovetail Public Authentication 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: Authentication
paths:
  /v1/token/info:
    get:
      description: 'Retrieve information about the API token used to authenticate this request. Use this endpoint to verify that your token is valid and to determine which workspace it belongs to.


        Returns the token''s unique identifier and the subdomain of the associated Dovetail workspace. This is useful for confirming connectivity before making further API calls, or for identifying which workspace a token grants access to in multi-workspace setups.'
      summary: Token info
      tags:
      - Authentication
      parameters: []
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: The unique identifier of the API token.
                      subdomain:
                        type: string
                        description: The subdomain of the Dovetail workspace that this token is associated with (e.g. 'acme' for acme.dovetail.com).
                    required:
                    - id
                    - subdomain
                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: getV1TokenInfo
      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