Creates a new analysis for the original period and unchanged source settings. Changed or removed sources require a new analysis from their current view.
Creates a new analysis for the original period and unchanged source settings. Changed or removed sources require a new analysis from their current view.
Browser session: __Host-mb_session cookie.
Machine management credentials in Authorization: Bearer. Check the permissions (scopes) required by the operation.
When using a browser session for a mutation, send the current CSRF token in X-CSRF-Token with the same-site cookie. OAuth consent uses its documented form field.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/json
Field
Type and limits
Required
Meaning
$
object; {"additionalProperties":false}
Yes
—
$.id
string; {"format":"uuid"}
Yes
—
$.status
string
Yes
—
$.background
boolean
Yes
—
Stable error codes
unavailable
analysis_capacity
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
This change does not have a general retry guarantee. If the response is unclear, read the affected resource before trying again. Follow Retry-After waiting times and request new sign-in or action codes when they expire.
HTTP 202 means the background job was accepted. Use the returned job ID to check its status. Download results when the job is complete, or inspect its error or cancellation status.
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.
Export numeric history at the selected raw, minute, quarter-hour or hourly resolution. Set multipart=true for up to 60,000 measurements and 25 MiB across at most 64 files, each limited to 2,000 measurements and 512 KiB. Set preview=true to estimate size without starting a job. Without multipart, existing single-file limits apply. Completed jobs include checksums and links for every part. UTC times, coverage, gap records and available counter increases/resets remain included. No part is published if the whole export fails. Cancel active jobs when no longer needed; downloads expire after one day. State and event history remains available as JSON.
Read status and progress of your authorized history job. Completed multipart CSV jobs include all part URLs, row counts, sizes, SHA-256 checksums and explicit coverage in the result. No part is available before the whole range succeeds.