Get Endpoint

← HTTP API reference

View source specification ↗

GET /endpoints/{id}

Read one authorized endpoint with its persisted writable-document etag and current effective metadata.

Required scope

endpoint:read

Path parameters

idstringRequired: URL-encoded complete endpoint identifier.

Returns

200

Endpoint retrieved.

Fields

Response headers

ETagstring: Opaque strong entity tag of the returned resource version. Send it back in `If-Match` on the next mutation of the same resource.

Errors

404 NOT_FOUND

Endpoint not found.

Verify the target identifier and that its endpoint or plugin route still exists.