Dovetail
dovetailDovetail 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.
Acciones disponibles (18)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create ChannelDOVETAIL_CREATE_CHANNELAcciónTool to create a new channel in dovetail. use after confirming channel details.
DOVETAIL_CREATE_CHANNELAcciónTool to create a new channel in dovetail. use after confirming channel details.
Parámetros de entrada
namestringObligatorioThe name of the channel.
typestringObligatorioenumType of the channel (public or private).
publicprivatemembersstring[]Optional list of member user IDs to add to the channel.
metadataobjectOptional arbitrary metadata about the channel.
descriptionstringOptional description of the channel.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ContactDOVETAIL_CREATE_CONTACTAcciónTool to create a new contact in dovetail. use when you need to register a contact before logging interactions.
DOVETAIL_CREATE_CONTACTAcciónTool to create a new contact in dovetail. use when you need to register a contact before logging interactions.
Parámetros de entrada
namestringObligatorioThe contact's name.
emailanyObligatorioemailThe contact's email address.
Parámetros de salida
dataobjectObligatorioWrapper object containing the created contact data.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Data PointDOVETAIL_CREATE_DATA_POINTAcciónTool to create a data point within a channel. use after capturing new content to record and classify it in dovetail.
DOVETAIL_CREATE_DATA_POINTAcciónTool to create a data point within a channel. use after capturing new content to record and classify it in dovetail.
Parámetros de entrada
textstringObligatorioThe data point's content, length between 1 and 5,000,000 characters
metadataobjectOptional key-value metadata to include with the data point
timestampanyObligatoriodate-timeThe data point's timestamp in ISO8601 format
channel_idstringObligatorioUnique identifier of the channel that the data point is associated with
source_urlanyuriThe URL of the original source from which this data point was extracted (optional)
source_titlestringThe title of the original source from which this data point was extracted (optional)
Parámetros de salida
dataobjectObligatorioResponse data for a created data point.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create InsightDOVETAIL_CREATE_INSIGHTAcciónTool 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'."
DOVETAIL_CREATE_INSIGHTAcciónTool 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'."
Parámetros de entrada
bodystringObligatorioThe main content of the insight.
tagsstring[]Tags for categorizing the insight.
titlestringObligatorioThe title of the insight.
project_idstringID of the related project. If omitted, the insight will not be tied to a specific project.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create TopicDOVETAIL_CREATE_TOPICAcciónTool to create a new topic in a channel. use after confirming channel id, title, and optional description.
DOVETAIL_CREATE_TOPICAcciónTool to create a new topic in a channel. use after confirming channel id, title, and optional description.
Parámetros de entrada
titlestringObligatorioTitle of the new topic
channel_idstringObligatorioUUID of the channel to add the topic to
descriptionstringOptional description or body of the topic
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete ChannelDOVETAIL_DELETE_CHANNELAcciónTool 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.
DOVETAIL_DELETE_CHANNELAcciónTool 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.
Parámetros de entrada
channel_idstringObligatorioThe unique identifier of the channel to delete. Deleted channel ends up in project's trash, restorable for 30 days.
Parámetros de salida
dataobjectObligatorioWrapper object containing the deleted channel details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TopicDOVETAIL_DELETE_TOPICAcciónTool 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."
DOVETAIL_DELETE_TOPICAcciónTool 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."
Parámetros de entrada
topic_idstringObligatorioUnique identifier of the topic to delete. Deleted topic ends up in project's trash, restorable for 30 days.
Parámetros de salida
dataobjectObligatorioWrapper object containing the deleted topic details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get NoteDOVETAIL_GET_NOTEAcciónTool to retrieve details of a specific note. use when you have confirmed the note id and need full note metadata from dovetail.
DOVETAIL_GET_NOTEAcciónTool to retrieve details of a specific note. use when you have confirmed the note id and need full note metadata from dovetail.
Parámetros de entrada
note_idstringObligatorioUnique identifier of the note to retrieve
Parámetros de salida
dataobjectObligatorioRetrieved note details
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Token InfoDOVETAIL_GET_TOKEN_INFOAcciónTool to get information about the current api token. use after authenticating to verify token scopes and expiry.
DOVETAIL_GET_TOKEN_INFOAcciónTool to get information about the current api token. use after authenticating to verify token scopes and expiry.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioWrapper object containing the current token's information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List ContactsDOVETAIL_LIST_CONTACTSAcciónTool to list all contacts in dovetail. use after authenticating with a valid workspace token when you need the complete contact list.
DOVETAIL_LIST_CONTACTSAcciónTool to list all contacts in dovetail. use after authenticating with a valid workspace token when you need the complete contact list.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioList of contacts returned by the API.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List DataDOVETAIL_LIST_DATAAcciónTool 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.
DOVETAIL_LIST_DATAAcciónTool 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.
Parámetros de entrada
sortstringSort expression using Dovetail Sort syntax. See https://developers.dovetail.com/docs/sort.
filterstringFilter expression using Dovetail Filters syntax. See https://developers.dovetail.com/docs/filters.
page[limit]integerNumber of items to return per page (1-100). Defaults to 100.
page[start_cursor]stringCursor to fetch the next page of results.
Parámetros de salida
dataobject[]ObligatorioList of data items returned by the API.
pageobjectObligatorioPagination details for navigating through results.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List HighlightsDOVETAIL_LIST_HIGHLIGHTSAcciónTool to list all highlights in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete highlight list.
DOVETAIL_LIST_HIGHLIGHTSAcciónTool to list all highlights in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete highlight list.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioList of highlights returned by the API.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List NotesDOVETAIL_LIST_NOTESAcciónTool to list all notes in dovetail. use after confirming you have a valid workspace token and need to retrieve the full note list.
DOVETAIL_LIST_NOTESAcciónTool to list all notes in dovetail. use after confirming you have a valid workspace token and need to retrieve the full note list.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioList of notes returned by the API.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List ProjectsDOVETAIL_LIST_PROJECTSAcciónTool to list all projects in dovetail. use after authenticating with a valid workspace token when you need to retrieve the full project list.
DOVETAIL_LIST_PROJECTSAcciónTool to list all projects in dovetail. use after authenticating with a valid workspace token when you need to retrieve the full project list.
Parámetros de entrada
pageintegerPage number to retrieve (minimum 1).
per_pageintegerNumber of projects to return per page (minimum 1).
Parámetros de salida
dataobject[]ObligatorioList of projects returned by the API.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List TagsDOVETAIL_LIST_TAGSAcciónTool to list all tags in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete tag list.
DOVETAIL_LIST_TAGSAcciónTool to list all tags in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete tag list.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
datastring[]ObligatorioList of tags associated with the workspace.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List User InsightsDOVETAIL_LIST_USER_INSIGHTSAcciónTool to list insights for a specific user. use when you need to retrieve all personal insights associated with a user id.
DOVETAIL_LIST_USER_INSIGHTSAcciónTool to list insights for a specific user. use when you need to retrieve all personal insights associated with a user id.
Parámetros de entrada
user_idstringObligatorioUnique identifier of the user whose insights will be listed.
Parámetros de salida
dataobject[]ObligatorioList of personal insights returned by the API.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Magic SearchDOVETAIL_MAGIC_SEARCHAcciónTool to perform a magic search across workspace data. use when you need to retrieve relevant highlights, notes, insights, channels, themes, or tags by query.
DOVETAIL_MAGIC_SEARCHAcciónTool to perform a magic search across workspace data. use when you need to retrieve relevant highlights, notes, insights, channels, themes, or tags by query.
Parámetros de entrada
pageintegerPage number for paginated results, 1-based
limitintegerMaximum number of items per type to return
querystringObligatorioText query to search across workspace data
typesstring[]Result types to include; defaults to all types if omitted
Parámetros de salida
dataobjectObligatorioSearch results container
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TopicDOVETAIL_UPDATE_TOPICAcciónTool 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'".
DOVETAIL_UPDATE_TOPICAcciónTool 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'".
Parámetros de entrada
titlestringNew title for the topic.
topic_idstringObligatorioUUID of the topic to update.
descriptionstringUpdated description for the topic.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not