Ingest Logs

Base URL: https://api.streamlogia.com

POST /v1/ingest Authorization: Bearer YOUR_API_KEY

Request body

Send a single entry or an array of entries. Both are accepted.

string

required

UUID of the project this log belongs to.

string

required

One of DEBUG, INFO, WARN, ERROR.

string

required

Human-readable description of the event. Max 8 KB.

string

required

Component or service that emitted the log — e.g. api.handler, payments-service. Used for filtering.

string

ISO 8601 timestamp — e.g. 2026-04-07T09:41:03Z. Defaults to the time of receipt if omitted.

string[]

Arbitrary labels for filtering — e.g. ["prod", "region:us-east"].

object

Arbitrary JSON context, max 64 KB — e.g. { "orderId": 9921, "traceId": "abc" }.

Examples

{
  "projectId": "YOUR_PROJECT_ID",
  "level": "ERROR",
  "message": "Payment failed: card declined",
  "source": "payments.processor",
  "timestamp": "2026-04-07T09:41:03Z",
  "tags": ["prod"],
  "meta": { "orderId": 9921, "userId": "usr_abc" }
}

[
  {
    "projectId": "YOUR_PROJECT_ID",
    "level": "ERROR",
    "message": "Unhandled exception in /v1/orders",
    "source": "api.handler"
  },
  {
    "projectId": "YOUR_PROJECT_ID",
    "level": "WARN",
    "message": "Connection pool at 90% capacity",
    "source": "db.pool"
  }
]

curl -X POST https://api.streamlogia.com/v1/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "YOUR_PROJECT_ID",
    "level": "ERROR",
    "message": "Payment failed: card declined",
    "source": "payments.processor",
    "timestamp": "2026-04-07T09:41:03Z",
    "tags": ["prod"],
    "meta": { "userId": "usr_abc", "amount": 4999 }
  }'

const res = await fetch("https://api.streamlogia.com/v1/ingest", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    projectId: "YOUR_PROJECT_ID",
    level: "ERROR",
    message: "Payment failed: card declined",
    source: "payments.processor",
    timestamp: "2026-04-07T09:41:03Z",
    tags: ["prod"],
    meta: { userId: "usr_abc", amount: 4999 },
  }),
});
const data = await res.json();
// { ingested: 1, ids: ["log_…"] }

import requests

res = requests.post(
    "https://api.streamlogia.com/v1/ingest",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "projectId": "YOUR_PROJECT_ID",
        "level": "ERROR",
        "message": "Payment failed: card declined",
        "source": "payments.processor",
        "timestamp": "2026-04-07T09:41:03Z",
        "tags": ["prod"],
        "meta": {"userId": "usr_abc", "amount": 4999},
    },
)
print(res.json())  # {'ingested': 1, 'ids': ['log_…']}

entry := LogEntry{
    ProjectID: "YOUR_PROJECT_ID",
    Level:     "ERROR",
    Message:   "Payment failed: card declined",
    Source:    "payments.processor",
    Timestamp: "2026-04-07T09:41:03Z",
}
ingest("YOUR_API_KEY", entry)

Response

{
  "ingested": 2,
  "ids": [
    "log_7f3a1b9c-e4d2-4f8a-b3c1-9d0e2f6a5b78",
    "log_2c8d4e6f-a1b3-5c7d-e9f0-1a2b3c4d5e6f"
  ]
}

integer

Number of entries stored.

string[]

Stable UUIDs for each entry, in request order.

Getting Started

API Reference

SDKs

Request body

Examples

Response

​Request body

​Examples

​Response

Request body

Examples

Response