Skip to content

Endpoint

HTTP API schema

← HTTP API reference

Endpoint fields

enablementEnablementRequired

enablement: Reference Enablement

idstringRequired

The unique identifier for the endpoint

pattern: "^port1/[^/]+/[^/]+/endpoints/[^/]+$"

nameTypeValueRequired

The name of the endpoint

typestringRequired

The type of endpoint

interfacesarray<ApplicationInterface>Required

List of interfaces supported by the endpoint

ownerIdstringRequired

The ID of the owner of the endpoint

descriptionTypeValue

The description of the route as a human readable string or a localizable asset.

manufacturerTypeValue

The manufacturer of the route as a human readable string or a localizable asset.

modelTypeValue

The model of the route as a human readable string or a localizable asset.

serialNumberTypeValue

The serial number of the route as a human readable string or a localizable asset.

parentEndpointIdstring

The endpoint this endpoint is part of, when a provider reports it as a component of another endpoint (for example a SmartThings oven cavity of its range). Derived from `IS_PART_OF` relationships between routes; when routes disagree the lowest parent endpoint ID is returned. Absent when the endpoint has no parent. Endpoint lists leave such endpoints out unless `includeChildEndpoints` is true; read one by its ID.

pattern: "^port1/[^/]+/[^/]+/endpoints/[^/]+$"

childEndpointIdsarray<string>

The IDs of the endpoints that are part of this endpoint, sorted. Absent when the endpoint has no children.

resourceGroupsarray<ResourceGroup>

List of associated resource groups

routesarray<Route>

List of associated routes

attributesarray<AttributeState>

Device state attributes for this endpoint. Query responses populate this array when `GET /endpoints` is called with `expand=interfaces.attributes`; otherwise it remains the default shallow shape.

View source specification ↗