​
Base URL

https://api.dawnai.com/api/v1

​
Authentication

All API requests must include your SDK write key in the Authorization header:

Authorization: Bearer YOUR_WRITE_KEY

You can get your api key by logging in to app.dawnai.com (bottom of the tab bar!)

​
Endpoints

​
Track Event

Track any event, including AI interactions and normal analytics events.

POST /events/track

Request Body

(Must be provided as an array of objects)

FieldTypeDescription
user_idstringThe unique identifier of the user
eventstringThe name of the event you want to track
propertiesobject(Optional) Additional properties associated with the event. To include image attachments that get rendered in chat, add it as a property like attachments : [{url: "link_to_image"}]
ai_dataobject(Optional) Object containing AI-specific data for AI events. If provided, either input or output (or both) is required.
ai_data.modelstring(Optional) The name of the AI model used
ai_data.inputstring(Optional) The input provided by the user. IF
ai_data.outputstring(Optional) The output generated by the AI
ai_data.convo_idstring(Optional) The conversation ID associated with the interaction

Example Request - AI Interaction

POST /events/track HTTP/1.1
Host: api.dawnai.com
Authorization: Bearer YOUR_WRITE_KEY
Content-Type: application/json

[{
  "user_id": "user123",
  "event": "ai_interaction",
  "properties": {
    "os_build": "17.1",
    "attachments": [
      {
          "type": "image",
          "value": "https://example.com/image.png",
          "role": "output"
      },
      {
          "type": "code",
          "name": "Example Code",
          "value": "console.log('Hello, World!');",
          "role": "input",
          "language": "javascript",
      },
    ]
  },
  "ai_data": {
    "model": "gpt_4",
    "input": "What is the weather like today?",
    "output": "The weather is sunny and warm.",
    "convo_id": "conv789"
  }
}]

Example Request - Normal Event

POST /events/track HTTP/1.1
Host: api.dawnai.com
Authorization: Bearer YOUR_WRITE_KEY
Content-Type: application/json

[{
  "user_id": "user123",
  "event": "product_viewed",
  "properties": {
    "product_id": "item456",
    "price": 9.99
  }
}]

Response

All authorized requests will return a 204 Success status code. For debugging failures, contact us: founders@dawnai.com

Event has a limit of 1 MB. Properties will be truncated for larger events.

​
Track Signal

Track user signals such as thumbs up, thumbs down, output schema failures, edits, regenerations, and other objective signals. Each signal must be associated with an event_id for an event that was sent to Dawn with the /events/track endpoint.

POST /signals/track

Request Body

(Must be provided as an array of objects)

FieldTypeDescription
event_idstringA unique identifier for the signal event
signal_namestringThe name of the signal (e.g., “thumbs_up”, “thumbs_down”)
timestampstring(Optional) ISO timestamp when the signal occurred
propertiesobject(Optional) Additional properties associated with the signal
attachment_idstring(Optional) Reference to a previously sent attachment
signal_typestring(Optional) Type of signal: “default”, “feedback”, “edit”, or “standard”

Example Request

POST /signals/track HTTP/1.1
Host: api.dawnai.com
Authorization: Bearer YOUR_WRITE_KEY
Content-Type: application/json

[{
  "event_id": "123456789",
  "signal_name": "thumbs_up",
  "properties": {
    "location": "chat_ui",
  },
  "signal_type": "default"
}]

Response

All authorized requests will return a 204 Success status code. For debugging failures, contact us: founders@dawnai.com

​
Identify User

Associate traits with a user.

POST /users/identify

Request Body

FieldTypeDescription
user_idstringThe unique identifier of the user
traitsobjectThe traits associated with the user

Example Request

POST /users/identify HTTP/1.1
Host: api.dawnai.com
Authorization: Bearer YOUR_WRITE_KEY
Content-Type: application/json

{
  "user_id": "user123",
  "traits": {
    "name": "John Doe",
    "email": "john@example.com",
    "age": 30,
    "plan": "paid", //we recommend 'free', 'paid', 'trial'
  }
}

Response

All authorized requests will return a 204 Success status code. For debugging failures, contact us: founders@dawnai.com

Was this page helpful?