Shared conventions across Tasks and Lumen APIs.
https://api.projecthollow.comhttps://projecthollow.com/lumen/ingesthttps://projecthollow.com/monitoring/ingest is the older URL, kept working for existing integrations.
All endpoints accept and return JSON payloads. Include Content-Type: application/json on all requests carrying a body.
Supply an Idempotency-Key header or an idempotencyKey field in the request body to prevent duplicate processing. On the Tasks API, re-submitting a request with an existing idempotency key returns the original record with {"duplicate": true}.
On the Lumen API a key is also the identity of the resource it created. Creating a monitor, alert rule, notification channel or maintenance window requires one (without it the call fails with MISSING_IDEMPOTENCY_KEY), and a repeat call with the same key does not return the original untouched: it applies the new request to that resource and answers 200 with {"id": "…", "duplicate": true}. A field you leave out of the repeat call is reset, so send the whole resource each time. Lumen remembers a key for 30 days from the call that created the resource; after that, the same key creates a new one.
All error responses adhere to a standard error structure:
{ "error": { "code": "RATE_LIMITED", "status": 429, "message": "Rate limit exceeded" } }MISSING_TEXT, MISSING_FIELD, MISSING_ENTRIES, MISSING_POINTS, MISSING_IDEMPOTENCY_KEY, INVALID_FIELD, INVALID_REQUEST, INVALID_KIND_IMMUTABLE, CHANNEL_OUT_OF_SCOPE, TOO_MANY_ENTRIES, TOO_MANY_POINTSMISSING_AUTH_HEADER, INVALID_KEY_FORMAT, INVALID_KEY, KEY_REVOKEDACCOUNT_NOT_APPROVED, INSUFFICIENT_SCOPE (the key lacks the scope the route needs), FORBIDDEN (a Space role below what the action needs)NOT_FOUND: target endpoint or record does not exist.CONFLICT: concurrent calls shared an idempotency key before execution finished.PAYLOAD_TOO_LARGE: request body exceeds maximum 256 KiB size limit.RATE_LIMITED, QUOTA_EXCEEDED or, on the Lumen API, RESOURCE_LIMIT_EXCEEDED when you already have as many monitors, alert rules, channels or windows as your plan allows.LOOKUP_TIMEOUT: the key could not be verified in time. Retry.