NUnullplatform
Report versions

Change published visibility

Changed on

Publishes a new version using the current published content with the new visibility, and updates the draft to match. Returns 204 if the visibility is unchanged, and 400 if the report has no published version.

patch/report/{id}/visibility

Request

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

Path parameters

idstring uuid required

The unique identifier of the report.

Request body

visibility'user' | 'organization' required

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

Example request

{
  "visibility": "user"
}

Response

The new published version created with the new visibility.

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