/analytics/{datasetSlug}/rollups/{rollupId}/reattestRe-attest Rollup
Confirms the rollup's configuration is still wanted: resets its attestation to now and, optionally, sets a new reattestIntervalDays (7, 30, 90 or 365).
A rollup whose attestation expired resumes.
Returns the rollup with its new expiresAt.
Only a person can re-attest: a service, workload or extension token gets 403 K9O_RBAC_DENY (reason: human_only); a personal access token acts as its person.
Requires the datasets:write permission (PROJECT_ADMIN or PROJECT_AUTHOR by default).
Callers must be members of the project (an organization role alone does not grant access); project service tokens and extension tokens cannot call it.
| datasetSlug * | path | The Dataset's slug. |
| rollupId * | path | The id of the rollup to re-attest ( It must belong to the dataset in the path. |
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| reattestIntervalDays | any | A new attestation window in days: 7, 30, 90 or 365. Omit it to keep the rollup's current window. |
| One of: 7 | ||
| or: 30 | ||
| or: 90 | ||
| or: 365 | ||
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 400 | K9O_INVALID_REQUEST_SHAPE | The request body does not match the schema. |
| 401 | K9O_UNAUTHENTICATED | The caller is not signed in. |
| 403 | K9O_ACCESS_DENIED | The caller is not a member of this project; an organization role alone does not grant access. |
| 403 | K9O_IAM_POLICY_DENIED | The caller's role or IAM policy does not grant datasets:write. |
| 403 | K9O_RBAC_DENY | Only a person can re-attest; service, workload and extension tokens are refused (reason human_only). A session is required to re-attest a rollup: a personal access token alone is refused with `context.reason` `session_required`, and a service, workload or extension token with `human_only`. |
| 404 | K9O_NOT_FOUND | The project was not found for this caller (project service tokens and extension tokens cannot call this endpoint). |
| data * | object | The rollup, with its new attestation. |
| id * | string | The rollup's id ( |
| slug * | string | The rollup's slug, unique in the project. Its read and subscribe paths use it. |
| subjectField * | any | The source event field that names the data subject. Null when the rollup declares |
| One of: string | ||
| or: null | ||
| nonPersonal * | boolean | True when the rollup's creator declared that its source carries no personal data. |
| datasetSlug * | string | The dataset the rollup writes its cells to. |
| source * | string | The source the rollup folds: a Pulse Stream's slug, or a telemetry signal name. Falls back to the stored stream id when the stream no longer exists. |
| dimensions * | string[] | The fields each cell is grouped by, in declared order (at most 16). |
| measures * | object[] | The declared measures, in order (at most 64). |
| name * | string | The measure's name: its key in each cell's |
| agg * | string | The aggregation: |
| column | string | The source field aggregated. Absent for |
| windowSeconds * | integer | The width of each cell's time window, in seconds. |
| enabled * | boolean | Whether the rollup is set to fold. |
| reattestIntervalDays * | integer | How many days each attestation lasts: 7, 30, 90 or 365. |
| attestedAt * | string <date-time> | When a person last confirmed the rollup (created or re-attested it). |
| expiresAt * | string <date-time> |
After it the rollup stops folding until it is re-attested. |
| attestationStatus * | "active" | "expiring_soon" | "expired" |
|
| cursorSequence * | any | The source sequence the last committed fold reached, as a decimal string. Null until a fold has written a cell. |
| One of: string | ||
| or: null | ||
| lastFoldAt * | any | When the last fold ran. Null if it has never run. |
| One of: string <date-time> | ||
| or: null | ||
| lastFoldStatus * | any | How the last fold ended: Null if it has never run. |
| One of: string | ||
| or: null | ||
| createdAt * | string <date-time> | When the rollup was created. |
| meta * | any | |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.analytics.rollups.reattest('<datasetSlug>', '<rollupId>', {})Showing example in TypeScript
{
"reattestIntervalDays": 7
}{
"data": {
"id": "string",
"slug": "string",
"subjectField": "string",
"nonPersonal": false,
"datasetSlug": "string",
"source": "string",
"dimensions": [
"string"
],
"measures": [
{
"name": "string",
"agg": "string",
"column": "string"
}
],
"windowSeconds": 0,
"enabled": false,
"reattestIntervalDays": 0,
"attestedAt": "string",
"expiresAt": "string",
"attestationStatus": "active",
"cursorSequence": "string",
"lastFoldAt": "string",
"lastFoldStatus": "string",
"createdAt": "string"
}
}