Ingest a single error or exception
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/errors" \ -H "Content-Type: application/json" \ -d '{ "exceptionClass": "TypeError", "message": "Cannot read properties of undefined (reading \'userId\')", "stackTrace": [ "at getUserId (auth.js:42:18)", "at validateSession (session.js:17:5)", "at Object.<anonymous> (index.js:88:3)" ], "level": "error", "environment": "production", "release": "v2.1.0", "user": { "id": "usr_1234", "email": "[email protected]" }, "metadata": { "route": "/dashboard", "browser": "Chrome 120" } }'{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000"
},
"meta": {
"requestId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"timestamp": "2026-03-31T12:00:00.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"
}
}