POST
/
v2
/
logs
curl --request POST \
  --url https://sdk.playerzero.app/v2/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-PzBucket: <x-pzbucket>' \
  --header 'X-PzProd: <x-pzprod>' \
  --data '[
  {
    "traceId": "<string>",
    "spanId": "<string>",
    "type": "<string>",
    "value": "<string>",
    "ts": "<string>",
    "qty": 123,
    "attributes": {}
  }
]'

This is an advanced feature. We recommend exploring our SDKs and other integrations first before implementing a direct integration with our API endpoint. The most common use case for this endpoint is to send errors and tracked events from mobile and iOS devices.

Authorizations

Authorization
string
headerrequired

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

Headers

X-PzProd
boolean
required

Specifies whether this data is coming from a production source or not.

X-PzBucket
string
required

The name of the dataset you'd like to associate this data to. Not required, but highly recommended.

Body

application/json · object[]
traceId
string

The traceId associated with the log, if there is one.

spanId
string

The spanId associated with the log, if there is one.

type
string
required

Must be one of

  • FATAL
  • ERROR
  • WARN
  • INFO
  • DEBUG
  • TRACE
value
string
required

The value of the event. This may be something like Opened App or Started Onboarding. Label this as something that would cue you to know what the user was doing in this moment.

ts
string
required

The timestamp of the event in JSON format (ie. 2023-11-25T13:08:50.782Z)

qty
number
default: 1

The number of times the log occurred. Default is 1.

attributes
object

A key, value pairing of arbitrary event metadata that is useful to tag to your event.