# JSON

## Overview

This procedure opens and reads a JSON file from either a specified S3 URL or uploaded directly to Kognitos. It retrieves the file content, parses it as JSON, and returns the JSON object.

## Input

| Concept | Type   | Description                              | Required | Default |
| ------- | ------ | ---------------------------------------- | -------- | ------- |
| file    | string | The S3 URL of the JSON file to be opened | Yes      | N/A     |

## Output

| Concept | Description                            |
| ------- | -------------------------------------- |
| json    | The JSON object obtained from the file |

## Examples

### 1. Opening a JSON file from S3

This example opens a JSON file stored at the specified S3 URL and returns the parsed JSON object.

```kog
the file is "s3://my-bucket/data/json.json"
open a json at the string
```

### 2. Opening a JSON file from an uploaded file

This example opens a JSON file that was uploaded by the user to Kognitos.

```kog
the file
open the json at the file
```

### 3. Reading a JSON file from S3

This example reads a JSON file stored at the specified S3 URL and returns the parsed JSON object. This is an alternative syntax to "open a json at a file" and provides the same functionality.

```kog
the file is "s3://my-bucket/data/json.json"
read the json from the file
```

### 4. Reading a JSON file from an uploaded resource

This example demonstrates reading a JSON file containing student and course information from a test resource. The result would be a JSON object with nested structures for student details and course arrays.

```kog
the file is "s3://bucket-name/resources/example.json"
read the json from the file
```

### 5. Error handling for invalid JSON files

This example shows the error handling when attempting to read an invalid or non-existent JSON file. The system will prompt with "Could not read a json from a file."

```kog
the invalid file is "some-file"
read the json from the invalid file
```


---

# 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.kognitos.com/legacy/legacy-experience/automation-areas/summary-1/to-open-a-json-at-a-file.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.