v1

latestOpenAPI 3.1.02026-07-26461279.9 KB
Public Apps

The batch method lets you send a series of identify, group, track, page and screen requests in a single batch, saving on outbound requests.

post/api/public/apps/batch

Headers

authorizationstring required

Authorization header for the request, in the format Bearer <token>. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.

Request body

contextobject

Provides metadata about the user submitting the event and the context in which the event occurred.

Example request

{
  "batch": [
    {
      "messageId": "23d04926-78e5-4ebc-853f-f26c84ff629e",
      "timestamp": "2024-04-22T07:00:00.000Z",
      "traits": {
        "name": "Michael Scott",
        "items": [
          {
            "id": 1,
            "name": "Paper"
          },
          {
            "id": 2,
            "name": "Stapler"
          }
        ]
      },
      "context": {
        "ip": "192.0.2.1"
      },
      "userId": "1043"
    }
  ],
  "context": {
    "ip": "192.0.2.1"
  }
}

Response

An empty String

string required

An empty String