Contribute — API key, opt-in

Report a failed call you observed to a public API host.

Counts once per organization, host and error class per 15 minutes. Shown publicly only when 3+ organizations report and the failure is confirmed; each confirmed report adds +5 Ask questions (max 50/day). Only hosts on /agent/hosts.json; the organization must turn on contributing. Reference: /agents/api

post/v1/observations

Request

  • Base URL: https://outage.me
  • URL: https://outage.me/v1/observations
  • Auth: API key in header x-tarantula-api-key

Request body

hoststring required

Hostname from /agent/hosts.json only: no scheme, port, path or query.

error_class'http_5xx' | 'timeout' | 'connection_refused' | 'dns_failure' | 'tls_error' required
regionstring

Where your software runs. Never published.

report_tokenstring

Single-use token offered by a status answer (MCP).

Response

Recorded (pending), already counted (duplicate) or paused (ignored)

status'pending' | 'duplicate' | 'ignored' required
hoststring
servicestring
windowstring
credit_on_confirmationinteger
reasonstring

Changes

No recorded changes to this operation across all 1 revision of this API.