NUnullplatform
Report versions

Roll back to a version

Changed on

Makes an earlier version the published one. Does not modify the draft.

post/report/{id}/versions/{versionId}/rollback

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/report/{id}/versions/{versionId}/rollback
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The unique identifier of the report.

versionIdstring uuid required

The unique identifier of a published version.

Response

The version that is now published.

idstring uuid

The unique identifier of this version.

report_idstring uuid

The ID of the report this version belongs to.

version_numberinteger

The sequential version number, starting at 1.

namestring

The report's display name at the time this version was published.

slugstring

The report's slug at the time this version was published.

descriptionstring

The report's description at the time this version was published.

schemaobject

The JSON Schema snapshot included in this version.

ui_schemaobject

The UI Schema snapshot included in this version.

queriesQueries

A map of query IDs to query definitions. Each ID is a name you choose to identify the query within the report.

visibility'user' | 'organization'

Who can see the report. user keeps it private to its owner; organization shares it with the whole organization.

published_bystring

The ID of the user who published this version.

created_atstring date-time

The ISO 8601 timestamp of when this version was published.

updated_atstring date-time

The ISO 8601 timestamp of this version's last update.

Example response

{
  "id": "183ab994-792a-412a-91fa-60552ff1aa7f",
  "report_id": "ff5970bf-592d-4a8d-b858-3175ec444562",
  "version_number": 1,
  "name": "Deployment frequency",
  "slug": "deployment-frequency",
  "description": "How often each application deploys",
  "visibility": "user",
  "published_by": "1234",
  "created_at": "2026-07-20T12:00:00Z",
  "updated_at": "2026-07-20T12:00:00Z"
}

Changes