> For the complete documentation index, see [llms.txt](https://docs.metaid.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metaid.io/metaid-specification/host.md).

# Host

## \<path>

The path where the PIN is located. There are three modes to represent `path` as follows:

* Starts with "/": Locates the PIN to be created through the path, e.g., `/protocols/simplebuzz`.
* Starts with "#": Locates the PIN through the PINNumber.
* Starts with "@": Locates the PIN through the PINID.

This is a required option.

## host

```json
**<**path> {host}:{path}
```

In `<path>`, `host` can be an address or a MetaName, for example:

Address: `1PKZnf7DxP69TFTHyzPc5KBidph6yuPKyG`,

```json
1PKZnf7DxP69TFTHyzPc5KBidph6yuPKyG:/protocols/simplebuzz
```

When `host` is included in `<path>`, it declares the source of the data, understood as the host header. This is optional.

If `host` is a MetaName, it must not exceed 32 characters, e.g., MetaName: `alice.metaid`

```json
alice.metaid:/protocols/simplebuzz
```
