ScanopyScanopy
Ports

Update a port

PUT
/api/v1/ports/{id}
Authorization<token>

User API key (Bearer scp_u_...). Create in Platform > API Keys.

In: header

Path Parameters

id*string

Port ID

Formatuuid

Request Body

application/json

host_id*string

The host this entity belongs to.

Formatuuid
network_id*string

The network this entity belongs to.

Formatuuid
number*integer

TCP or UDP port number

Range0 <= value <= 65535
protocol*string

Transport protocol the port is open on.

Value in"Udp" | "Tcp"
type?string

Well-known port identifier. Auto-derived from number+protocol, so it is optional on create.

Value in"Ssh" | "Telnet" | "DnsUdp" | "DnsTcp" | "Samba" | "Nfs" | "Ftp" | "Ipp" | "LdpTcp" | "LdpUdp" | "Ldap" | "Ldaps" | "Kerberos" | "Snmp" | "SnmpAlt" | "Rdp" | "Ntp" | "Sip" | "SipTls" | "Rtsp" | "Dhcp" | "Http" | "MySql" | "PostgreSQL" | "MongoDB" | "Redis" | "MsSql" | "Docker" | "DockerTls" | "Kubernetes" | "RabbitMqMgmt" | "Cassandra" | "Elasticsearch" | "InfluxDb" | "CouchDb" | "Kafka" | "Http3000" | "Http5000" | "Http8080" | "Http8081" | "Http8082" | "Http8888" | "Http9000" | "Https" | "Https8443" | "Https9443" | "Https10443" | "Mqtt" | "MqttTls" | "AMQP" | "AMQPTls" | "Wireguard" | "OpenVPN" | "BACnet" | "JetDirect" | "Custom"

Response Body

application/json

application/json

application/json

curl -X PUT "https://app.scanopy.net/api/v1/ports/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "created_at": "2026-01-15T10:30:00Z",    "first_discovery_id": null,    "host_id": "550e8400-e29b-41d4-a716-446655440003",    "id": "550e8400-e29b-41d4-a716-446655440006",    "last_discovery_id": null,    "last_seen_at": "2026-01-15T10:30:00Z",    "lineage_id": null,    "network_id": "550e8400-e29b-41d4-a716-446655440002",    "number": 80,    "protocol": "Tcp",    "type": "Http",    "updated_at": "2026-01-15T10:30:00Z",    "valid_from": "2026-01-15T10:30:00Z",    "valid_to": null  }'
{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.8"
  },
  "success": true,
  "data": {
    "created_at": "2026-01-15T10:30:00Z",
    "first_discovery_id": null,
    "host_id": "550e8400-e29b-41d4-a716-446655440003",
    "id": "550e8400-e29b-41d4-a716-446655440006",
    "last_discovery_id": null,
    "last_seen_at": "2026-01-15T10:30:00Z",
    "lineage_id": null,
    "network_id": "550e8400-e29b-41d4-a716-446655440002",
    "number": 80,
    "protocol": "Tcp",
    "type": "Http",
    "updated_at": "2026-01-15T10:30:00Z",
    "valid_from": "2026-01-15T10:30:00Z",
    "valid_to": null
  },
  "error": "string"
}
{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.8"
  },
  "success": true,
  "code": "string",
  "error": "string",
  "params": {
    "property1": null,
    "property2": null
  }
}
{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.8"
  },
  "success": true,
  "code": "string",
  "error": "string",
  "params": {
    "property1": null,
    "property2": null
  }
}