---
title: "HttpServer"
url: https://una-lang.org/en/docs/std/host/HttpServer/
release: v0.4.0
edition: "0.4, 0.5 preview"
source: https://github.com/una-lang/una/blob/v0.4.0/docs/std/listing.json
---

# HttpServer

A capability of the module `std.host`, which a module imports by name; the prelude does not put it in scope ([`spec/31 §1`](https://una-lang.org/en/docs/spec/31-http-servers/1-the-capability/#s1)). Edition 0.4, 0.5 preview.

```una
pub capability HttpServer
  op next() -> internal Exchange
    fails ServeError
    accepts internal
  op reply(to: ReplyRight, reply: Reply) -> Unit
    fails ServeError
    accepts internal
  op close() -> Unit
    accepts public
```

The server side of HTTP/1.1, on the addresses that `serve` grants allow (`spec/31 §1`, ADR 0123 rules 1 to 5). `next` waits for a request and gives the calling task its reply right; `reply` answers it once and never waits; `close` stops accepting connections, and accepts `public` only, so no request decides it.

## Specification

- [`spec/31 §1`](https://una-lang.org/en/docs/spec/31-http-servers/1-the-capability/#s1)

Generated from the standard modules of una v0.4.0 ([`docs/std/listing.json`](https://github.com/una-lang/una/blob/5fec93d88932b333feec25e589355a2cb34c37b5/docs/std/listing.json), which is not part of the specification). The specification governs: [`spec/14 §1`](https://una-lang.org/en/docs/spec/14-standard-library/#s1).
