Dovetail

Learn how to use Dovetail with Composio

Overview

SLUG

DOVETAIL

Description

Dovetail is an Australian software company that provides tools for transcription analysis, coding interpretation of interviews, survey responses, and feedback, enabling users to create summarized insights from their research analysis.

Authentication Details

bearer_token
stringRequired

Tools

SLUG: DOVETAIL_CREATE_CHANNEL

Tool to create a new channel in dovetail. use after confirming channel details.

Action Parameters

description
string
members
array
metadata
object
name
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_CREATE_CONTACT

Tool to create a new contact in dovetail. use when you need to register a contact before logging interactions.

Action Parameters

email
Required
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_CREATE_DATA_POINT

Tool to create a data point within a channel. use after capturing new content to record and classify it in dovetail.

Action Parameters

channel_id
stringRequired
metadata
object
source_title
string
source_url
text
stringRequired
timestamp
Required

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_CREATE_INSIGHT

Tool to create a new insight in dovetail. use after synthesizing findings when ready to store them. example: "create insight 'q1 user trends' with body '...' for project 'proj 123'."

Action Parameters

body
stringRequired
project_id
string
tags
array
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_CREATE_TOPIC

Tool to create a new topic in a channel. use after confirming channel id, title, and optional description.

Action Parameters

channel_id
stringRequired
description
string
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_DELETE_CHANNEL

Tool to delete an existing channel. use when you need to remove a channel and move it to the project's trash (restorable for 30 days). confirm the channel id before calling.

Action Parameters

channel_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_DELETE_TOPIC

Tool to delete an existing topic. use when you have confirmed the topic id and want to move it to trash (restorable for 30 days). example: "delete topic with id 123e4567-e89b-12d3-a456-426614174000."

Action Parameters

topic_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_GET_NOTE

Tool to retrieve details of a specific note. use when you have confirmed the note id and need full note metadata from dovetail.

Action Parameters

note_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_GET_TOKEN_INFO

Tool to get information about the current api token. use after authenticating to verify token scopes and expiry.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_CONTACTS

Tool to list all contacts in dovetail. use after authenticating with a valid workspace token when you need the complete contact list.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_DATA

Tool to list data items in dovetail. use when you need to retrieve, filter, sort, or paginate through your workspace data after authentication. supports dovetail filters, sort syntax, and cursor-based pagination.

Action Parameters

filter
string
page[limit]
integer
page[start_cursor]
string
sort
string

Action Response

data
arrayRequired
error
string
page
objectRequired
successful
booleanRequired

SLUG: DOVETAIL_LIST_HIGHLIGHTS

Tool to list all highlights in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete highlight list.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_NOTES

Tool to list all notes in dovetail. use after confirming you have a valid workspace token and need to retrieve the full note list.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_PROJECTS

Tool to list all projects in dovetail. use after authenticating with a valid workspace token when you need to retrieve the full project list.

Action Parameters

page
integer
per_page
integer

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_TAGS

Tool to list all tags in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete tag list.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_LIST_USER_INSIGHTS

Tool to list insights for a specific user. use when you need to retrieve all personal insights associated with a user id.

Action Parameters

user_id
stringRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: DOVETAIL_UPDATE_TOPIC

Tool to update an existing topic. use after confirming the topic id and fields to change. example: "update topic with id 123... to have title 'new'".

Action Parameters

description
string
title
string
topic_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired