OAuth

Get OAuth client metadata for administration

Changed on

Retrieves one OAuth client metadata record for an authenticated administrator.

User and delegated-user principals must have the persisted ADMIN business role. Delegated Aura Historia access-token callers must also have the access-tokens:read capability. The response contains client metadata, redirect URIs, and scopes, but never a plaintext client secret, secret hash, or masked secret value. Every success and error response uses Cache-Control: no-store.

get/api/v1/admin/oauth-clients/{clientId}

Request

  • Base URL: https://api.stage.aura-historia.com
  • URL: https://api.stage.aura-historia.com/api/v1/admin/oauth-clients/{clientId}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

clientIdstring required

Canonical OAuthClient ID.

Response

OAuth client metadata retrieved successfully.

client_idstring required

Canonical OAuthClient ID.

client_namestring required

Display name of the OAuth client.

tos_uristring uri required

Terms-of-service document URL registered for the OAuth client.

policy_uristring uri required

Privacy-policy document URL registered for the OAuth client.

client_uristring uri required

Homepage or product-site URL registered for the OAuth client.

logo_uristring uri required

Logo image URL registered for the OAuth client.

redirect_urisstring[] required

Registered redirect URIs for the OAuth client.

scopeAccessTokenScopeData[] required

Allowed scopes for tokens issued to this OAuth client.

client_id_issued_atinteger required

Unix timestamp (seconds) when the OAuth client was created and its client ID was issued.

Example response

{
  "client_id": "oc_7b0gwc1x49e0mvbt3tfexfqgb5",
  "client_name": "Dashboard integration",
  "tos_uri": "https://client.example/tos",
  "policy_uri": "https://client.example/policy",
  "client_uri": "https://client.example",
  "logo_uri": "https://client.example/logo.png",
  "redirect_uris": [
    "https://client.example/callback"
  ],
  "scope": [
    "access-tokens:read"
  ],
  "client_id_issued_at": 1748539200
}

Changes

  • d6278283f0e4Revision changes
    • warning

      added the new admin-overview:read enum value to the / response property for the response status

    • warning

      added the new auctions:write enum value to the / response property for the response status

    • warning

      added the new listing-sources:read enum value to the / response property for the response status

    • warning

      added the new notifications:read enum value to the / response property for the response status

    • warning

      added the new notifications:write enum value to the / response property for the response status

    • warning

      added the new parties:read enum value to the / response property for the response status

    • warning

      added the new parties:write enum value to the / response property for the response status

    • warning

      added the new partnership-applications:read enum value to the / response property for the response status

    • warning

      added the new partnership-applications:write enum value to the / response property for the response status

    • warning

      added the new partnerships:read enum value to the / response property for the response status

    • warning

      added the new partnerships:write enum value to the / response property for the response status

    • warning

      added the new search-filters:read enum value to the / response property for the response status

  • b854c7fa001bRevision changes
    • warning

      added the new auctions:read enum value to the / response property for the response status