POST
/
v1
/
channels
/
data
Create data point
curl --request POST \
  --url https://dovetail.com/api/v1/channels/data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "text": "Support email requesting a trial for Dovetail app.",
  "channel_id": "<string>",
  "timestamp": "<string>",
  "source_title": "<string>",
  "source_url": "<string>",
  "metadata": {}
}'
{
  "data": {
    "id": "<string>",
    "channel": {
      "id": "<string>"
    },
    "timestamp": "<string>",
    "created_at": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Body

text
string
required

The data point's content, used to analyze and classify the data point.

Required string length: 1 - 5000000
Example:

"Support email requesting a trial for Dovetail app."

channel_id
string
required

Unique identifier of the channel that the data point is associated with.

timestamp
string
required

The data point's timestamp in ISO8601 format.

source_title
string

The title of the original source from which this data point was extracted.

Required string length: 1 - 100
source_url
string

The URL of the original source from which this data point was extracted.

Required string length: 1 - 5000
metadata
object

Optional key-value metadata to be included with the data point.

Response

201

data
object
required