---
title: "Exposes a port on a cluster."
method: POST
path: "/cluster/{cluster_id}/port"
tags: ["clusters"]
---

# Exposes a port on a cluster.

`POST /cluster/{cluster_id}/port`

Required RBAC Policy: kots/cluster/[:clusterid]/port/expose

## Path parameters

- `cluster_id` string, required

## Request body

- object
  - `is_wildcard` boolean — IsWildcard
  - `port` integer, required — Port Number
  - `protocols` PortProtocol[], required — Protocols

## Response `201`

CreateClusterPortResponse contains the response to a create cluster port request

- object
  - `addon` ClusterAddon
    - `cluster_guid` string
    - `cluster_id` string
    - `created_at` string, date-time
    - `guid` string
    - `id` string
    - `object_store` ClusterAddonObjectStore
      - `bucket_name` string
      - `bucket_prefix` string
      - `service_account_name` string
      - `service_account_name_read_only` string
      - `service_account_namespace` string
    - `port` ClusterAddonPort
      - `is_wildcard` boolean
      - `name` string
      - `protocol_http` boolean
      - `protocol_https` boolean
      - `protocol_ws` boolean
      - `protocol_wss` boolean
      - `upstream_port` integer
    - `ready_at` string, date-time
    - `status` string
    - `terminated_at` string, date-time
    - `total_credits` integer
  - `port` ClusterPort
    - `addon_guid` string
    - `addon_id` string
    - `cluster_guid` string
    - `cluster_id` string
    - `created_at` string, date-time
    - `exposed_ports` ClusterExposedPort[]
      - `exposed_port` integer
      - `protocol` string
    - `hostname` string
    - `is_wildcard` boolean
    - `port_name` string
    - `state` string
    - `upstream_port` integer

## Other responses

- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3-2.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3-2/versions/6fcf9e54aba4/schema)