Skip to main content
POST/analytics/{datasetSlug}/rollups/{rollupId}/reattest

Re-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.

Parameters
datasetSlug *path

The Dataset's slug.

rollupId *path

The id of the rollup to re-attest (rollup_...), as create and list return it.

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.

Request body
reattestIntervalDaysany

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
Responses
HTTPK9O CodeDescription
200Success
400K9O_INVALID_REQUEST_SHAPEThe request body does not match the schema.
401K9O_UNAUTHENTICATEDThe caller is not signed in.
403K9O_ACCESS_DENIEDThe caller is not a member of this project; an organization role alone does not grant access.
403K9O_IAM_POLICY_DENIEDThe caller's role or IAM policy does not grant datasets:write.
403K9O_RBAC_DENYOnly 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`.
404K9O_NOT_FOUNDThe project was not found for this caller (project service tokens and extension tokens cannot call this endpoint).
Response body (200)
data *object

The rollup, with its new attestation.

id *string

The rollup's id (rollup_...).

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 nonPersonal instead (or, for a rollup made before declarations were required, neither).

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 measures.

agg *string

The aggregation: count, last, sum, avg, min, max, count_distinct, p50, p95 or p99.

columnstring

The source field aggregated.

Absent for count.

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>

attestedAt plus reattestIntervalDays.

After it the rollup stops folding until it is re-attested.

attestationStatus *"active" | "expiring_soon" | "expired"

expiring_soon within 14 days of expiresAt, expired after it.

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: ok for a clean fold, otherwise why it did not fold (for example attestation_expired, stale_principal_denied, dataset_gone, write_error or failed).

Null if it has never run.

One of: string
or: null
createdAt *string <date-time>

When the rollup was created.

meta *any
TypeScript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.analytics.rollups.reattest('<datasetSlug>', '<rollupId>', {})

Showing example in TypeScript

Request example
{
  "reattestIntervalDays": 7
}
Response example (200)
{
  "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"
  }
}

More in Analytics & Intelligence