MetriBeacon
Menu

GET Read an analysis job

/api/v1/analysis-jobs/{id}

Workspace SLOs use the aggregate availability series of HTTP, TCP, UDP, DNS, TLS, ping, service, domain and browser monitors. Unknown and unobserved time remain explicit; satisfaction is only proven by the lower availability bound. Ten SLOs and three report schedules are allowed per workspace. Calendar reports are immutable for 90 days. Email requires explicit owner opt-in and a verified destination, and shares the existing notification quota. Asynchronous jobs share four global slots and one per owner, can be cancelled and cannot cross workspace boundaries. Choose daily, weekly or monthly reports and a dispatch time (HH:MM) in an IANA timezone. Reports cover the previous local calendar day, Monday–Sunday week or month. Processing starts at that time; delivery may be later. During daylight-saving changes, a missing time moves to the next valid minute and a repeated time runs only once. Manual generation uses the last closed period regardless of the dispatch time.

On this page

Access and permissions

Workspace SLOs use the aggregate availability series of HTTP, TCP, UDP, DNS, TLS, ping, service, domain and browser monitors. Unknown and unobserved time remain explicit; satisfaction is only proven by the lower availability bound. Ten SLOs and three report schedules are allowed per workspace. Calendar reports are immutable for 90 days. Email requires explicit owner opt-in and a verified destination, and shares the existing notification quota. Asynchronous jobs share four global slots and one per owner, can be cancelled and cannot cross workspace boundaries. Choose daily, weekly or monthly reports and a dispatch time (HH:MM) in an IANA timezone. Reports cover the previous local calendar day, Monday–Sunday week or month. Processing starts at that time; delivery may be later. During daylight-saving changes, a missing time moves to the next valid minute and a repeated time runs only once. Manual generation uses the last closed period regardless of the dispatch time.

Browser session: __Host-mb_session cookie.

Machine management credentials in Authorization: Bearer. Check the permissions (scopes) required by the operation.

Parameters and headers

FieldLocationType and limitsRequiredMeaning
idPathstring; {"format":"uuid"}YesResource ID in this workspace

Request body

No request body.

Responses

application/json

FieldType and limitsRequiredMeaning
$objectYes—
$.completed_atstring; {"format":"date-time"} | nullYes—
$.completed_at (anyOf 1)string; {"format":"date-time"}No—
$.completed_at (anyOf 2)nullNo—
$.created_atstring; {"format":"date-time"}Yes—
$.delivery_statusstring | nullYes—
$.delivery_status (anyOf 1)stringNo—
$.delivery_status (anyOf 2)nullNo—
$.error_codestring | nullYes—
$.error_code (anyOf 1)stringNo—
$.error_code (anyOf 2)nullNo—
$.idstringYes—
$.kindstringYes—
$.period_endstring; {"format":"date-time"}Yes—
$.period_startstring; {"format":"date-time"}Yes—
$.resultnull | object; {"additionalProperties":true} | object; {"additionalProperties":false}Yes—
$.result (oneOf 1)nullNo—
$.result (oneOf 2)object; {"additionalProperties":true}No—
$.result (oneOf 2).slosarray<object>Yes—
$.result (oneOf 2).slos[]objectYes—
$.result (oneOf 2).incidentsintegerNo—
$.result (oneOf 2).resolved_incidentsintegerNo—
$.result (oneOf 2).reportingReportingResultNo—
$.result (oneOf 2).reporting.versioninteger; {"const":1}Yes—
$.result (oneOf 2).reporting.definitionReportingDefinitionYes—
$.result (oneOf 2).reporting.definition.adjustedbooleanNo—
$.result (oneOf 2).reporting.definition.chart_sourcesarray<string; {"maxLength":200}>; {"maxItems":8}No—
$.result (oneOf 2).reporting.definition.chart_sources[]string; {"maxLength":200}Yes—
$.result (oneOf 2).reporting.definition.filtersReportingFiltersYes—
$.result (oneOf 2).reporting.definition.filters.channelstring; {"enum":["","email","telegram","discord","slack","ntfy","webhook","webpush"]}No—
$.result (oneOf 2).reporting.definition.filters.filesystemstring; {"maxLength":512}No—
$.result (oneOf 2).reporting.definition.filters.group_idsarray<string; {"format":"uuid"}>; {"maxItems":1000}No—
$.result (oneOf 2).reporting.definition.filters.group_ids[]string; {"format":"uuid"}Yes—
$.result (oneOf 2).reporting.definition.filters.location_idsarray<string; {"format":"uuid"}>; {"maxItems":1000}No—
$.result (oneOf 2).reporting.definition.filters.location_ids[]string; {"format":"uuid"}Yes—
$.result (oneOf 2).reporting.definition.filters.monitor_idsarray<string; {"format":"uuid"}>; {"maxItems":1000}No—
$.result (oneOf 2).reporting.definition.filters.monitor_ids[]string; {"format":"uuid"}Yes—
$.result (oneOf 2).reporting.definition.filters.resourcestring; {"enum":["","cpu","memory","filesystem","disk","network"]}No—
$.result (oneOf 2).reporting.definition.filters.severitystring; {"enum":["","info","warning","critical"]}No—
$.result (oneOf 2).reporting.definition.filters.typesarray<string; {"maxLength":32}>; {"maxItems":1000}No—
$.result (oneOf 2).reporting.definition.filters.types[]string; {"maxLength":32}Yes—
$.result (oneOf 2).reporting.definition.granularitystring; {"enum":["hour","day","week","month"]}Yes—
$.result (oneOf 2).reporting.definition.languagestring; {"enum":["en","de"]}No—
$.result (oneOf 2).reporting.definition.sectionsarray<string; {"enum":["overview","availability","incidents","mttr","mtta","response","maintenance","notifications","certificates","jobs","resources"]}>; {"maxItems":11,"minItems":1}Yes—
$.result (oneOf 2).reporting.definition.sections[]string; {"enum":["overview","availability","incidents","mttr","mtta","response","maintenance","notifications","certificates","jobs","resources"]}Yes—
$.result (oneOf 2).reporting.definition.timezonestring; {"maxLength":64}Yes—
$.result (oneOf 2).reporting.definition.versioninteger; {"const":1}No—
$.result (oneOf 2).reporting.fromstring; {"format":"date-time"}Yes—
$.result (oneOf 2).reporting.tostring; {"format":"date-time"}Yes—
$.result (oneOf 2).reporting.snapshot_atstring; {"format":"date-time"}Yes—
$.result (oneOf 2).reporting.filter_namesobject | nullYes—
$.result (oneOf 2).reporting.retained_fromobject | nullYes—
$.result (oneOf 2).reporting.sourcesarray | nullYes—
$.result (oneOf 2).reporting.sources[]object; {"additionalProperties":false}Yes—
$.result (oneOf 2).reporting.sources[].idstringYes—
$.result (oneOf 2).reporting.sources[].namestringYes—
$.result (oneOf 2).reporting.sources[].typestringYes—
$.result (oneOf 2).reporting.sources[].created_atstring; {"format":"date-time"}Yes—
$.result (oneOf 2).reporting.sources[].availabilitystringNo—
$.result (oneOf 2).reporting.sectionsarray<ReportingSection>; {"maxItems":11}Yes—
$.result (oneOf 2).reporting.sections[]ReportingSectionYes—
$.result (oneOf 2).reporting.sections[].idstringYes—
$.result (oneOf 2).reporting.sections[].columnsarray<object; {"additionalProperties":false}>Yes—
$.result (oneOf 2).reporting.sections[].columns[]object; {"additionalProperties":false}Yes—
$.result (oneOf 2).reporting.sections[].columns[].keystringYes—
$.result (oneOf 2).reporting.sections[].columns[].label_keystringYes—
$.result (oneOf 2).reporting.sections[].columns[].kindstring; {"enum":["number","text","datetime"]}Yes—
$.result (oneOf 2).reporting.sections[].columns[].unitstringNo—
$.result (oneOf 2).reporting.sections[].summaryarray<object; {"additionalProperties":false}>Yes—
$.result (oneOf 2).reporting.sections[].summary[]object; {"additionalProperties":false}Yes—
$.result (oneOf 2).reporting.sections[].summary[].keystringYes—
$.result (oneOf 2).reporting.sections[].summary[].valuenumber | nullYes—
$.result (oneOf 2).reporting.sections[].summary[].unitstringNo—
$.result (oneOf 2).reporting.sections[].chartsarray<ReportingChart>Yes—
$.result (oneOf 2).reporting.sections[].charts[]ReportingChartYes—
$.result (oneOf 2).reporting.sections[].charts[].idstringYes—
$.result (oneOf 2).reporting.sections[].charts[].title_keystringYes—
$.result (oneOf 2).reporting.sections[].charts[].plotsarray<object; {"additionalProperties":false}>; {"maxItems":8}Yes—
$.result (oneOf 2).reporting.sections[].charts[].kindstring; {"enum":["bar"]}No—
$.result (oneOf 2).reporting.sections[].completenessstring; {"enum":["complete","partial"]}Yes—
$.result (oneOf 2).reporting.sections[].reasonsarray<string>Yes—
$.result (oneOf 2).reporting.sections[].reasons[]stringYes—
$.result (oneOf 2).reporting.sections[].row_countinteger; {"minimum":0}Yes—
$.result (oneOf 2).reporting.sections[].rowsarray<ReportingRow>No—
$.result (oneOf 2).reporting.sections[].rows[]ReportingRowYes—
$.result (oneOf 2).reporting.sections[].rows[].idstringYes—
$.result (oneOf 2).reporting.sections[].rows[].monitor_idstring; {"format":"uuid"}No—
$.result (oneOf 2).reporting.sections[].rows[].namestringYes—
$.result (oneOf 2).reporting.sections[].rows[].valuesobject; {"additionalProperties":true}Yes—
$.result (oneOf 3)object; {"additionalProperties":false}No—
$.result (oneOf 3).currentobject; {"additionalProperties":false}Yes—
$.result (oneOf 3).current.availabilitynumber | nullYes—
$.result (oneOf 3).current.response_msnumber | nullYes—
$.result (oneOf 3).current.coverage_percentnumberYes—
$.result (oneOf 3).current.comparablebooleanYes—
$.result (oneOf 3).current.pointsarray<object; {"additionalProperties":false}>; {"maxItems":60}Yes—
$.result (oneOf 3).current.points[]object; {"additionalProperties":false}Yes—
$.result (oneOf 3).current.points[].timestring; {"format":"date-time"}Yes—
$.result (oneOf 3).current.points[].availabilitynumber | nullYes—
$.result (oneOf 3).current.points[].response_msnumber | nullYes—
$.result (oneOf 3).current.points[].coverage_percentnumberYes—
$.result (oneOf 3).previousobject; {"additionalProperties":false}Yes—
$.result (oneOf 3).previous.availabilitynumber | nullYes—
$.result (oneOf 3).previous.response_msnumber | nullYes—
$.result (oneOf 3).previous.coverage_percentnumberYes—
$.result (oneOf 3).previous.comparablebooleanYes—
$.result (oneOf 3).previous.pointsarray<object; {"additionalProperties":false}>; {"maxItems":60}Yes—
$.result (oneOf 3).previous.points[]object; {"additionalProperties":false}Yes—
$.result (oneOf 3).previous.points[].timestring; {"format":"date-time"}Yes—
$.result (oneOf 3).previous.points[].availabilitynumber | nullYes—
$.result (oneOf 3).previous.points[].response_msnumber | nullYes—
$.result (oneOf 3).previous.points[].coverage_percentnumberYes—
$.result (oneOf 3).fromstringYes—
$.result (oneOf 3).tostringYes—
$.result (oneOf 3).snapshot_atstringYes—
$.result (oneOf 3).comparablebooleanYes—
$.result (oneOf 3).revisionstringYes—
$.snapshot_atstring; {"format":"date-time"}Yes—
$.statusstringYes—
$.workspace_idstringYes—
$.expires_atstring; {"format":"date-time"}No—
$.error_detailobject; {"additionalProperties":false}No—
$.error_detail.message_keystringYes—
$.error_detail.message_paramsobject; {"additionalProperties":true}Yes—
$.progressinteger; {"minimum":0,"maximum":100}No—
$.phasestring; {"enum":["waiting","calculating","publishing","completed","failed","cancelled"]}No—
$.started_atstring | null; {"format":"date-time"}No—
$.calculation_msnumber | null; {"minimum":0}No—
Stable error codes
invalid_session

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
csrf
forbidden
insufficient_scope
owner_required

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
not_found

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
idempotency_conflict
job_not_active
job_not_ready
revision_conflict

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
invalid_idempotency_key
invalid_report
invalid_slo
csv_not_supported

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
alarm_limit
analysis_capacity
report_limit
slo_limit

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—
Stable error codes
unavailable

application/problem+json

FieldType and limitsRequiredMeaning
$ProblemYes—
$.codestringYesStable machine-readable error code
$.detailstringYesShort localized explanation without internal error details
$.instancestringYesUnique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.messagestringYesTemporarily identical to detail for existing clients
$.message_keystringYesStable translation key for changing the displayed language without another request
$.message_paramsobject; {"additionalProperties":true}YesNamed, safely rendered message parameters; never arbitrary HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}YesServer-generated diagnostic identifier. It contains no login token or credential.
$.statusinteger; {"maximum":599,"minimum":400}Yes—
$.titlestringYesLocalized HTTP status title
$.typestring; {"const":"about:blank"}Yes—

Retries and asynchronous work

This operation reads or validates without applying a resource mutation. Respect rate limits and credential lifetime.

Request examples

Replace demo IDs, timestamps and placeholders with your own values. For a retry, keep the same IDs, time and content. These examples do not run requests on this page.

Keep login links, codes, cookies and keys private. Do not print them in logs or share them in support requests.

shell
curl --silent --show-error --output /dev/null --write-out "%{http_code}\n" --request GET --header @"$HOME/.config/metribeacon/headers.txt" "https://metribeacon.com/api/v1/analysis-jobs/00000000-0000-4000-8000-000000000001"
python
import json
from pathlib import Path
from urllib.request import Request, HTTPRedirectHandler, build_opener
from urllib.error import HTTPError
headers=json.loads((Path.home()/".config/metribeacon/headers.json").read_text())
class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, request, fp, code, message, headers, target): return None
request=Request('https://metribeacon.com/api/v1/analysis-jobs/00000000-0000-4000-8000-000000000001',data=None,headers=headers,method='GET')
try:
    with build_opener(NoRedirect()).open(request,timeout=10) as response: print(response.status)
except HTTPError as error:
    print(error.code)
    error.close()
javascript
import {readFile} from "node:fs/promises";
import {homedir} from "node:os";
import {join} from "node:path";
const headers=JSON.parse(await readFile(join(homedir(),".config/metribeacon/headers.json"),"utf8"));
const response=await fetch("https://metribeacon.com/api/v1/analysis-jobs/00000000-0000-4000-8000-000000000001",{method:"GET",headers,redirect:"manual",signal:AbortSignal.timeout(10000)});
console.log(response.status);await response.body?.cancel();
go
package main
import("encoding/json";"fmt";"net/http";"os";"path/filepath";"time")
func main(){home,e:=os.UserHomeDir();if e!=nil{return};raw,e:=os.ReadFile(filepath.Join(home,".config/metribeacon/headers.json"));if e!=nil{return};var headers map[string]string;if json.Unmarshal(raw,&headers)!=nil{return};req,e:=http.NewRequest("GET","https://metribeacon.com/api/v1/analysis-jobs/00000000-0000-4000-8000-000000000001",nil);if e!=nil{return};for k,v:=range headers{req.Header.Set(k,v)};client:=&http.Client{Timeout:10*time.Second,CheckRedirect:func(*http.Request,[]*http.Request)error{return http.ErrUseLastResponse}};res,e:=client.Do(req);if e!=nil{return};defer res.Body.Close();fmt.Println(res.StatusCode)}
  • HTTP API, OAuth and MCP

    Find the user API endpoints, their permissions, fields, examples and response formats.

  • DELETE Cancel an analysis job

    Workspace SLOs use the aggregate availability series of HTTP, TCP, UDP, DNS, TLS, ping, service, domain and browser monitors. Unknown and unobserved time remain explicit; satisfaction is only proven by the lower availability bound. Ten SLOs and three report schedules are allowed per workspace. Calendar reports are immutable for 90 days. Email requires explicit owner opt-in and a verified destination, and shares the existing notification quota. Asynchronous jobs share four global slots and one per owner, can be cancelled and cannot cross workspace boundaries. Choose daily, weekly or monthly reports and a dispatch time (HH:MM) in an IANA timezone. Reports cover the previous local calendar day, Monday–Sunday week or month. Processing starts at that time; delivery may be later. During daylight-saving changes, a missing time moves to the next valid minute and a repeated time runs only once. Manual generation uses the last closed period regardless of the dispatch time.

  • GET Export a completed report as CSV

    Download the CSV of a completed period report. SLO evaluation jobs have JSON results and return csv_not_supported (422) for CSV; unfinished report jobs return job_not_ready (409).

  • POST Prepare a report export

    Creates or reuses an export of the completed snapshot. CSV includes every filtered row of one section. PDF accepts one section or * for all selected sections. PDF is limited to 60 seconds, 20 MiB and 100 pages; excessive output fails without truncation.