Get text overrides
GET /v1/branding/texts/{screen}/{locale} · permission branding:read
Returns the text overrides of one hosted page screen and locale in the environment scope, or in an application or organization scope (application_id / org_id). Keys without an override use the built-in catalog text. Overrides become live on publish.
Request
| Field | Type | Required | Description |
|---|---|---|---|
screen |
path | yes | Hosted page screen (e.g. login, authorize). |
locale |
path | yes | Supported locale (e.g. en, tr). |
application_id |
query | no | Application scope (app_…). Without it and org_id the environment scope is used. |
org_id |
query | no | Organization scope (org_…). Cannot be combined with application_id. |
Response
200 OK with every override of the scope, screen and locale.
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
Errors
| HTTP | code | When |
|---|---|---|
| 404 | not_found |
The application_id or org_id is malformed, or the application does not exist in this environment. |
| 422 | validation_failed |
Both application_id and org_id were given (mutually_exclusive), or one was repeated (repeated). |
| 401 | unauthenticated |
The credential is missing, invalid or revoked. |
| 403 | insufficient_permissions |
The credential lacks the required permission. |
| 429 | rate_limited |
The rate limit was exceeded; retry after the Retry-After period. |
| 503 | service_unavailable |
A dependency is temporarily unavailable; retry after the Retry-After period. |
Example
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"