horizon.json File Format¶

CONVERGE Horizon writes a horizon.json file for every job. If you have installed the CLI, you can use horizon.json (or an edited version of it) as input for a new job with the job:create command. This file contains key:value pairs in standard JSON format. If you edit a horizon.json file, copy the contents into a JSON linter to validate that it is formatted correctly.

Example horizon.json file for job created in web interface¶

{
   "id": "9f9ea1f4-b807-45f7-866c-f3f88df143dd",
   "created_at": "2025-08-12T22:11:48.000000Z",
   "name": "APP1234-H2-DI",
   "app_key": "converge",
   "app_version": "5.0.2",
   "cores_per_node": 126,
   "memory_per_node": 252,
   "cli": null,
   "executable": null,
   "interactive": false,
   "license_type": "on-demand",
   "license_server": null,
   "node_template_id": "0uJbrzvsWhkJ",
   "nodes_target": 1,
   "nodes_min": 1,
   "storage_id": "9cce1356-e332-4a9a-b5b8-0b5b170212f2",
   "storage_path": "Hydrogen_spark_ignition\/Sandia_hydrogen_DI_engine_ECFM_transient_RANS\/",
   "storage_type": "space",
   "output_compress": 0,
   "time_limit_app": 2,
   "time_limit_queue": 24
}

The available keys for horizon.json are listed below. The subset of keys in a given horizon.json file will depend on how the job was created and which options were specified.

Key	Description
id*	Job ID
created_at*	Date and time of job creation
name	Job name
app_args	Custom application arguments
app_key	Application
app_version	Application version
batch_id	ID of the associated batch
cores_per_node	Flex cores if the job was run on a VM, otherwise Cores per node
memory_per_node	Flex memory
cli*	Custom commands
executable	Custom executable
interactive	Interactive mode
license_type	License type
license_server	Custom license server
node_template_id	ID of the selected node type
nodes_target	Target number of nodes
nodes_min	Minimum number of nodes
project_id	Name or ID of the selected project
storage_id	Name or ID of the selected file system or space
storage_path	Path to directory containing the input files
storage_type	“filesystem” or “space”
output_compress	Output file compression
time_limit_app	Application time limit
time_limit_queue	Maximum queue time

* Written to horizon.json only for jobs created in the web interface. Ignored when horizon.json is used as input for job:create.