Skip to content

API reference / RivetMSP

Diagnostics

POST /crash-reports Public

Report a mobile app crash (logged to App Logs, category "mobile_crash")

Semi-public: reachable without a valid bearer token, because the crash most worth seeing is exactly the one that happens before login succeeds or while a token is invalid/expired. A token is honored for caller correlation when present, but never required.

Request body (application/json, required)

FieldTypeDescription
platform string
app_version_name string
app_version_code integer
device_model string
os_version string
sdk_int integer
thread_name string
is_fatal boolean
occurred_at string (date-time)
stack_tracerequired string

Example request

curl -X POST "https://YOUR-HOST/api/v1/crash-reports" \
  -H "Content-Type: application/json" \
  -d '{"platform":"android","app_version_name":"1.13.0","app_version_code":19,"device_model":"Pixel 8","os_version":"15","sdk_int":35,"thread_name":"main","is_fatal":true,"occurred_at":"2026-01-01T09:00:00Z","stack_trace":"string"}'
import requests

response = requests.post(
    "https://YOUR-HOST/api/v1/crash-reports",
    json={
        "platform": "android",
        "app_version_name": "1.13.0",
        "app_version_code": 19,
        "device_model": "Pixel 8",
        "os_version": "15",
        "sdk_int": 35,
        "thread_name": "main",
        "is_fatal": True,
        "occurred_at": "2026-01-01T09:00:00Z",
        "stack_trace": "string"
    },
)
print(response.json())
const response = await fetch("https://YOUR-HOST/api/v1/crash-reports", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "platform": "android",
      "app_version_name": "1.13.0",
      "app_version_code": 19,
      "device_model": "Pixel 8",
      "os_version": "15",
      "sdk_int": 35,
      "thread_name": "main",
      "is_fatal": true,
      "occurred_at": "2026-01-01T09:00:00Z",
      "stack_trace": "string"
  }),
});
const data = await response.json();
$ch = curl_init("https://YOUR-HOST/api/v1/crash-reports");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"platform":"android","app_version_name":"1.13.0","app_version_code":19,"device_model":"Pixel 8","os_version":"15","sdk_int":35,"thread_name":"main","is_fatal":true,"occurred_at":"2026-01-01T09:00:00Z","stack_trace":"string"}',
]);
$data = json_decode(curl_exec($ch), true);

Responses

201Logged

FieldTypeDescription
logged boolean
Example response
json
{
    "logged": true
}

400Bad request

FieldTypeDescription
error string

429Rate limit exceeded (see Retry-After header)

FieldTypeDescription
error string