Creates an Ethernet switch port.

The port ID and subtype of a switch port are used to associate a switch port with a HELD device in order to resolve a geolocation.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The switch to which the switch port belongs.

Body Params

The request body containing the port ID and port ID subtype.

A request to update a switch port's port ID data. Requires HELD and supported for unmanaged switches only.

string | null

The organization ID.

string | null

The opational geolocation ID for the port.

string
required
length ≥ 1

Gets or sets the port ID.

string
enum
Responses
200

OK when successful with the Ethernet switch port in the body.

400

BAD REQUEST if port is not unmanaged or any validation errors occur.

401

UNAUTHORIZED when the access token is invalid or expired.

403

FORBIDDEN when the permissions to update the Ethernet switch port is not granted.

404

NOT FOUND when the Ethernet switch port is not found.

500

INTERNAL SERVER ERROR on any unexpected errors.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!