---
title: "Read HTTP exposure"
description: "Read the computer's independent HTTP exposure without changing its lifecycle state."
canonical: "https://www.cool.computer/docs/api-reference/services/read-http-exposure"
---
# Read HTTP exposure

> Read the computer's independent HTTP exposure without changing its lifecycle state.

```http
GET https://api.cool.computer/api/computers/{id}/exposure
```

Read the computer's independent HTTP exposure without changing its lifecycle state. Computer-scoped guest credentials and authorized computer users may access this operation.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

## Parameters

- `id` (path, string, at least 1 characters, required): The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

## Responses

- `200`: The selected HTTP target and existing sharing policy. Port zero means no exposure; this does not assert application health.
  - `application/json` (object)
    - `url` (string, required): The computer's stable HTTPS URL, regardless of whether a route is selected.
    - `port` (integer, 0 to 65535, not 3129, 18080, 18088, required): Selected HTTP target. Zero means unexposed; not a health check.
    - `visibility` ("public" or "private", required)
- `400`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `401`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `403`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `404`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `409`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: A machine-readable error. Authorization and compute-access policy remain enforced.
- `default`: A machine-readable error. Authorization and compute-access policy remain enforced.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl "https://api.cool.computer/api/computers/$PARAM_ID/exposure" \
  -H "authorization: Bearer $TOKEN"
```
