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
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Honeycomb-Team
string
header
required

Authenticate using a Honeycomb Configuration Key.

Pass the Token in the X-Honeycomb-Team header:

X-Honeycomb-Team: 1234567890123456789012

If you created your key using the API, use data.attributes.secret; this is the same value as the Token in the UI.

To learn how to create a Configuration Key, visit Manage Environment API Keys. To learn more about authenticating requests, visit API Authentication.

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