POST
/
api
/
public
/
apps
/
page
cURL
curl --request POST \
  --url http://localhost:3001/api/public/apps/page \
  --header 'Content-Type: application/json' \
  --header 'PublicWriteKey: <api-key>' \
  --header 'authorization: <authorization>' \
  --data '{
  "messageId": "23d04926-78e5-4ebc-853f-f26c84ff629e",
  "timestamp": "2024-04-22T07:00:00.000Z",
  "name": "Home",
  "properties": {
    "title": "My Site",
    "url": "http://www.site.com"
  },
  "context": {
    "ip": "192.0.2.1"
  },
  "userId": "1043"
}'
"<string>"
The following is an example of a page body.
example body
{
  "name": "Overview",
  "userId": "1043",
  "properties": {
    "url": "/dashboard/overview"
  },
  "messageId": "1ff51c9c-4929-45de-8914-3bb878be8c4a"
}

Authorizations

​
PublicWriteKey
string
header
required

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

Headers

​
authorization
string
required

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

Body

application/json
​
messageId
string
required

Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.

Examples:

"23d04926-78e5-4ebc-853f-f26c84ff629e"

​
userId
string
required

Unique identifier for the user. Should be the id of the user in your system. Only applicable to logged in users.

Examples:

"1043"

"user-123"

"0a58e5e4-c753-477e-a6c4-f9b0e3396b9b"

​
timestamp
string

ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.

Examples:

"2024-04-22T07:00:00.000Z"

​
name
string

Name of the page visited by the user.

Examples:

"Home"

​
properties
object

Free-form dictionary of properties of the page, like url and referrer. Can contain arbitrary JSON values.

Examples:
{
  "title": "My Site",
  "url": "http://www.site.com"
}
​
context
object

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

Examples:
{ "ip": "192.0.2.1" }

Response

An empty String