Skip to content

Get OAuth Client Secret

← HTTP API reference
View source specification ↗
GET /{namespace}/{principalType}/{principalId}/oauth-clients/{clientId}/secrets/{secretId}

Reads immutable masked secret metadata and its strong etag. Plaintext and hashes are never returned.

Required scope

Any authenticated access token

Path parameters

namespacestringRequired

Resource namespace. Port OS resource identifiers use port1.

pattern: "^port1$"

principalTypestringRequired

The type of principal that owns the OAuth client

principalIdstringRequired

The ID of the principal that owns the OAuth client

clientIdstringRequired

The ID of the OAuth client

secretIdstringRequired

The ID of the OAuth client secret

Returns

200

Secret metadata.

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

403 FORBIDDEN

Current OAuth client management permission denied.

Check the linked account and its permissions for the device or resource.

404 NOT_FOUND

OAuth client or secret not found.

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