Ingest a single log entry
Authorization
ApiKeyAuth X-SeeStack-Key<token>
Raw API key for SDK ingestion endpoints. The backend validates this key and resolves the associated project automatically.
Send the raw key as-is.
Example: seestack_live_abc123xyz...
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "http://localhost:8080/ingest/v1/logs" \ -H "Content-Type: application/json" \ -d '{ "level": "warn", "message": "Payment retry attempt 3 of 5", "service": "payment-service", "traceId": "trace-b9f2a1c3", "metadata": { "orderId": "ORD-5512", "amount": 99.9, "currency": "SAR" } }'{
"success": true,
"data": {
"id": "660e8400-e29b-41d4-a716-446655440001"
},
"meta": {
"requestId": "8d0e7780-8536-51ef-a55c-f18gd2g01bf8",
"timestamp": "2026-03-31T12:00:01.000Z"
}
}{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid or missing API key"
},
"meta": {
"requestId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"timestamp": "2026-03-31T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": {
"exceptionClass": "must not be blank",
"level": "must match \"debug|info|warn|error|fatal|warning\""
}
},
"meta": {
"requestId": "8d0e7780-8536-51ef-a55c-f18gd2g01bf8",
"timestamp": "2026-03-31T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
},
"meta": {
"requestId": "9e1f8891-9647-62fg-b66d-g29he3h12cg9",
"timestamp": "2026-03-31T12:00:00.000Z"
}
}