Skip to main content

​
Endpoint

POST https://theslow.net/api/slowstats/ingest-metrics

​
Overview

This endpoint allows you to submit arbitrary metric data for a project.
Use it to track analytics, counters, or any structured data you want tied to your project.

​
Authentication

This endpoint requires an API key. You can retrieve an API key from your dashboard. Include it in the X-API-KEY header: 
X-API-KEY: YOUR_API_KEY_HERE
For more details, see the Authentication Guide.

​
Request Body

Send a JSON payload with the following structure:
FieldTypeRequiredDescription
projectIdstringYesID of the project to associate the metric with.
payloadobjectYesArbitrary JSON object representing the metric data.

​
Responses

​
✅ 200 OK

Metric successfully ingested: 
{
  "message": "Metric ingested successfully."
}

​
⚠️ 400 Bad Request

If projectId or payload is missing or invalid: 
{
  "error": "Project ID is required."
}
Or 
{
  "error": "Metric payload is required and must be an object."
}

​
🔒 401 Unauthorized

If authentication fails (invalid or missing API key): 
{
  "error": "Unauthorized: You must provide a valid API Key."
}

​
🚫 403 Forbidden

If the project does not belong to the authenticated user: 
{
  "error": "Forbidden: You do not have access to this project."
}

​
💥 500 Internal Server Error

For unexpected server errors: 
{
  "error": "An internal server error occurred."
}

​
Examples

​
CURL

curl -X POST "https://theslow.net/api/slowstats/ingest-metrics"      -H "Content-Type: application/json"      -H "X-API-KEY: YOUR_API_KEY_HERE"      -d '{
       "projectId": "abc123",
       "payload": {
         "temperature": 72.5,
         "humidity": 45
       }
     }'

​
Python (requests)

import requests

headers = {"X-API-KEY": "YOUR_API_KEY_HERE"}
data = {
  "projectId": "abc123",
  "payload": {
    "temperature": 72.5,
    "humidity": 45
  }
}

response = requests.post("https://theslow.net/api/slowstats/ingest-metrics", json=data, headers=headers)
print(response.json())

​
JavaScript (fetch)

fetch("https://theslow.net/api/slowstats/ingest-metrics", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": "YOUR_API_KEY_HERE"
  },
  body: JSON.stringify({
    projectId: "abc123",
    payload: {
      temperature: 72.5,
      humidity: 45
    }
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

​
Notes

  • This endpoint enforces ownership checks, meaning you can only submit metrics for projects tied to your API key.

​
Need Further Assistance?

If you have any questions or encounter issues, please don’t hesitate to reach out to our support team.