# Update HBJSON

![](https://3521261292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1FZ8W_xSW4Nb61%2Fuploads%2Fgit-blob-1660042852c988a11c1be33ed97eec98f46f8c4e%2FUpdate_HBJSON.png?alt=media)

![](https://3521261292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1FZ8W_xSW4Nb61%2Fuploads%2Fgit-blob-47c0949102ea19d8137622fea35f71548f3c231c%2FUpdate_HBJSON.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-core/blob/master/honeybee_grasshopper_core/src/HB%20Update%20HBJSON.py)

Upgrade a Model HBJSON file to the currently installed version of the schema.

This component can also upgrade to a specific version of the schema but it cannot downgrade the schema version or change the version of any honeybee object other than a Model.

A full list of honeybee-schema versions can be found on the honeybee-schema GitHub: <https://github.com/ladybug-tools/honeybee-schema/releases>

## Inputs

* **hbjson \[Required]**

  A file path to a Model HBJSON which will be upgraded to the currently installed version of the Honeybee Model schema (or a specific version specified below).&#x20;
* **version**

  Text to indicate the version to which the Model HBJSON will be updated (eg. 1.41.2). Versions must always consist of three integers separated by periods. If None, the Model HBJSON will be updated to the currently installed version of honeybee-schema.&#x20;
* **name**

  A name for the file to which the honeybee objects will be written. By default, it will have the same name as the input file but with "UPDATED" appended to the file name.&#x20;
* **folder**

  An optional directory into which the updated file will be written.  The default is set to the default simulation folder.&#x20;
* **validate**

  Boolean to note whether the Honeybee Model should be validated and checked for errors after it has been updated. This includes basic properties like adjacency and duplicate identifier checks as well as geometry checks for planarity, room solidity, etc.&#x20;
* **update \[Required]**

  Set to "True" to update the Model HBJSON to the currently installed version.&#x20;

## Outputs

* **report**

  Reports, errors, warnings, etc.&#x20;
* **hbjson**

  The file path to the updated HBJSON.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ladybug.tools/honeybee-primer/components/3_serialize/update_hbjson.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.