---
title: "POST /v2/{+name}:reportInfoSystem"
method: POST
path: "/v2/{+name}:reportInfoSystem"
tags: ["projects"]
---

# POST /v2/{+name}:reportInfoSystem

`POST /v2/{+name}:reportInfoSystem`

Allows notebook instances to report their latest instance information to the Notebooks API server. The server will merge the reported information to the instance metadata store. Do not use this method directly.

## Path parameters

- `name` string, required

## Request body

- ReportInstanceInfoSystemRequest — Request for notebook instances to report information to Notebooks API.
  - `event` Event — The definition of an Event for a managed / semi-managed notebook instance.
    - `type` 'EVENT_TYPE_UNSPECIFIED' | 'IDLE' | 'HEARTBEAT' | 'HEALTH' | 'MAINTENANCE' | 'METADATA_CHANGE' — Optional. Event type.
    - `details` object — Optional. Event details. This field is used to pass event information.
    - `reportTime` string, google-datetime — Optional. Event report time.
  - `vmId` string — Required. The VM hardware token for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/notebooks.md) · [All operations](https://skmtc.dev/google/apis/notebooks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/notebooks/revisions/127a2a41b4c1/schema)