SearchV2

Perform an advanced search across your entire Dovetail workspace. This is the recommended search endpoint, supporting all content types: agents, highlights, data (notes), insights, channels, dashboards, tags, themes, projects, folders, and people (contacts).

Filtering options:

  • types — Restrict results to specific content types (defaults to all types).
  • query — Full-text search string matched against titles and content.
  • location — Scope results to specific projects or folders using their IDs.
  • user — Filter by contributor or author.
  • tags / themes — Filter by tag or theme IDs.
  • people — Filter by contacts (people) mentioned in content.
  • fields — Filter by custom field values.
  • date — Filter by creation date range.
  • archived — Include archived items (default: false).

Results can be sorted by relevance (default) or other criteria, and are paginated using offset and limit (default 20, max 100). Each content type is returned in its own array within the response.

Required scope: search:read

post/v2/search

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v2/search
  • Auth
    HTTP bearer

Request body

offsetinteger

The number of items to skip before starting to collect the result set.

limitinteger

The number of items to return.

Response

200

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      the / request property's maxLength was set to 512

    • warning

      removed the optional property // from the response with the status

    • info

      added the new CONTRIBUTOR_IDS enum value to the request property //