HTTP REST API

You can use Logtail even if there's no official library for your programming language by sending your logs to our HTTP API.

This endpoint allows you to log a single event or a list of events. The events can be encoded in JSON or preferably in a more efficient MessagePack.

POST https://in.logtail.com

Headers

Content-Type

required string

Either application/json or application/msgpack

Authorization

required string

Bearer YOURLOGTAILSOURCE_TOKEN

Body parameters

Multiple events

required array

An array of log events encoded in JSON or MessagePack

Single event

required object

A single log event encoded in JSON or MessagePack

202

The event was, or the events were successfully logged.

403

You provided an invalid source token.

Response body

Unauthorized

406

The body is not a valid JSON or MessagePack.

Response body

Couldn't parse JSON content.

Example: Single event

cURL (JSON)

curl -X POST https://in.logtail.com \
     -H "Authorization: Bearer YOUR_LOGTAIL_SOURCE_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"message":"logtail is ready","nested":{"values":123}}'

Copied!

cURL (MessagePack)

curl -X POST https://in.logtail.com \
     -H "Authorization: Bearer YOUR_LOGTAIL_SOURCE_TOKEN" \
     -H "Content-Type: application/msgpack" \
     -d "\x82\xA7message\xB0logtail is ready\xA6nested\x81\xA6values{"

Copied!

Example: Multiple events

cURL (JSON)

curl -X POST https://in.logtail.com \
     -H "Authorization: Bearer YOUR_LOGTAIL_SOURCE_TOKEN" \
     -H "Content-Type: application/json" \
     -d '[{"message":"A"},{"message":"B"}]'

Copied!

cURL (MessagePack)

curl -X POST https://in.logtail.com \
     -H "Authorization: Bearer YOUR_LOGTAIL_SOURCE_TOKEN" \
     -H "Content-Type: application/msgpack" \
     -d "\x92\x81\xA7message\xA1A\x81\xA7message\xA1B"

Copied!

Logging with Docker and Logtail

Slack + Logtail Integration

Explore documentation

HTTP REST API

Example: Single event

Example: Multiple events