Skip to main content
POST
/
1
/
events
/
{datasetSlug}
Create an Event
curl --request POST \
  --url https://api.honeycomb.io/1/events/{datasetSlug} \
  --header 'Content-Type: application/json' \
  --header 'X-Honeycomb-Team: <api-key>' \
  --data '
{
  "method": "GET",
  "endpoint": "/foo",
  "shard": "users",
  "duration_ms": 32
}
'

Authorizations

​
X-Honeycomb-Team
string
header
required

A Honeycomb Configuration Key is required to use this API. A Configuration Key can be found in the API Keys section of the environment configuration, which can be found under Environment Settings -> API Keys -> Configuration tab. Check out our documentation to find your API Keys.

More information can be found in Manage Environments.

Headers

​
X-Honeycomb-Event-Time
integer

The Event's timestamp. Optional. Defaults to server time.

​
X-Honeycomb-Samplerate
integer

Optional. Defaults to 1.

Path Parameters

​
datasetSlug
string
required

The dataset slug.

Body

application/json

The request body is limited to raw (potentially compressed) size of 1MB.

The maximum number of distinct columns (fields) allowed in an event is 2000.

​
{key}

A collection of key-value properties that represent the Event. Honeycomb supports basic data types for the values of each Event attribute.

Limits

  • 2,000 fields per event. The entire event must be less than 1 MB of uncompressed JSON.
  • String Fields: Each string field has a maximum length of 64KB.
  • Number Fields: Integers and Floats are both 64-bit.

Response

Enqueued for processing