Data

Create a new data entry within a Dovetail project. Data entries capture raw research data — interview transcripts, survey responses, support tickets, or CRM records. They must be associated with a project via project_id.

You can provide the initial content as plain text or HTML via the content field, and attach custom field data via the fields array.

Returns the data object without the content body.

🚧 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.

Required scope: note:write

post/v1/data

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/data
  • Auth
    HTTP bearer

Request body

titlestring

The data's title.

contentstring

The initial content of the data, which may include plain text or HTML content.

project_idstring required

Unique identifier of the project that the data is associated with.

Example request

{
  "title": "My First Data",
  "content": "This is my new data that will talk about the key learnings of the interview."
}

Response

201

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

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

    • info

      added the required property / to the response with the status