Skip to main content
GET
/
.well-known
/
hp-configuration
cURL
curl --request GET \
  --url https://api.sandbox.humanity.org/v2/.well-known/hp-configuration
{
  "issuer": "<string>",
  "authorization_endpoint": "<string>",
  "token_endpoint": "<string>",
  "revoke_endpoint": "<string>",
  "userinfo_endpoint": "<string>",
  "jwks_uri": "<string>",
  "presets_endpoint": "<string>",
  "presets_batch_endpoint": "<string>",
  "credentials_endpoint": "<string>",
  "authorizations_endpoint": "<string>",
  "hp_configuration_endpoint": "<string>",
  "scopes_supported": [
    "<string>"
  ],
  "scopes_catalog": [
    {
      "id": "<string>",
      "display_name": "<string>",
      "description": "<string>",
      "category": "<string>",
      "implied_scopes": [
        "<string>"
      ],
      "is_default": true
    }
  ],
  "grant_types_supported": [
    "<string>"
  ],
  "code_challenge_methods_supported": [
    "<string>"
  ],
  "response_types_supported": [
    "<string>"
  ],
  "token_endpoint_auth_methods_supported": [
    "<string>"
  ],
  "subject_types_supported": [
    "<string>"
  ],
  "claim_types_supported": [
    "<string>"
  ],
  "claims_supported": [
    "<string>"
  ],
  "id_token_signing_alg_values_supported": [
    "<string>"
  ],
  "presets_available": [
    {
      "name": "<unknown>",
      "scope": "<string>",
      "type": "<unknown>",
      "description": "<string>",
      "consent_text": "<string>"
    }
  ],
  "rate_limit_default": 123,
  "rate_limit_unit": "<string>"
}
SDK equivalent
const config = await sdk.getConfiguration();
Returns Humanity-specific metadata that complements the standard OIDC discovery document:
  • Available preset catalog with labels and descriptions
  • OAuth endpoints (authorize, token, revoke, JWKS)
  • Environment-level feature flags and SLA hints
Call this during bootstrap to populate your UX or to double-check which presets are GA in the current region. Combine it with /.well-known/openid-configuration and /.well-known/jwks.json for full OIDC compliance.

Response

200 - application/json
​
issuer
string
required
​
authorization_endpoint
string
required
​
token_endpoint
string
required
​
revoke_endpoint
string
required
​
userinfo_endpoint
string
required
​
jwks_uri
string
required
​
presets_endpoint
string
required
​
presets_batch_endpoint
string
required
​
credentials_endpoint
string
required
​
authorizations_endpoint
string
required
​
hp_configuration_endpoint
string
required
​
scopes_supported
string[]
required
​
scopes_catalog
object[]
required
​
grant_types_supported
string[]
required
​
code_challenge_methods_supported
string[]
required
​
response_types_supported
string[]
required
​
token_endpoint_auth_methods_supported
string[]
required
​
subject_types_supported
string[]
required
​
claim_types_supported
string[]
required
​
claims_supported
string[]
required
​
id_token_signing_alg_values_supported
string[]
required
​
presets_available
object[]
required
​
rate_limit_default
number
required
​
rate_limit_unit
string
required