# httpRequest

Canonical ID: `network.request`.

```text
httpRequest(url, options)
```

Makes a declared and permitted HTTPS request using GET, HEAD, POST, PUT, PATCH, DELETE or OPTIONS. Options: method, body, format (text/json), headers and authorizationSecret. Authentication uses a host-selected origin-scoped secret; direct Cookie/Authorization headers are denied. Limits: 10 seconds, 1 MiB text/body, 64 KiB JSON. No redirects. Even GET through this API requires Pro.

Returns a Map with `ok`, `status`, `value` and `error`. Check `ok` before using `value`; denial or an unavailable host is a structured failure.

Requires Creator Pro or its technical trial for IDE/CLI run and build. Available on desktop, CLI and supported native exports; not in the public playground. Source remains editable in Learner. Generated apps have no Pliro licence check.

## Call example

See the [advanced application guide](../guides/advanced-applications.md) for declarations, explicit host permissions and complete examples. This call assumes the required permissions; `handle` means the `value` from a successful open operation.

```text
httpRequest("https://api.example.com/items", {"method": "GET", "format": "json"})
```

[Free bounded GET](getWebText.md) · [Built-ins](README.md)