Skip to content
getgeolens.com

Config

GET
/auth/config/
curl --request GET \
--url https://example.com/auth/config/

Return public auth configuration (no authentication required).

Successful Response

Media type application/json
ConfigResponse
object
allow_signup
Allow Signup

Whether self-serve registration is open. Alias for registration_enabled; login UI uses this to show/hide the signup link.

boolean
auth_methods
Auth Methods

Auth methods contributed by the active AuthExtension. Empty by default; compatible deployments may add methods such as [‘saml’]. Login UI can render conditional sign-in options without needing admin OAuthProvider access.

Array<string>
banner_color
Banner Color

Theme token for the site banner color: warning | info | success | destructive.

string
default: warning
banner_enabled
Banner Enabled

When true and banner_text is non-empty, the site-wide announcement banner is shown. Default false.

boolean
banner_text
Banner Text

Admin-configured site-wide announcement banner text. Empty string means no banner is shown.

string
""
demo_mode
Demo Mode

When true, logged-in users see a persistent demo-account banner. Default false — self-hosters see no banner.

boolean
email_verification_required
Email Verification Required

When true, new self-registered users must verify their email before logging in. Default false for back-compat-safe parsing by older clients.

boolean
landing_first
Landing First

When true, unauthenticated visits to ’/’ are redirected to ‘/login’ as the product landing page. Default false (search catalog is the root).

boolean
password_login_enabled
Password Login Enabled

When false, password login is disabled for users without manage_settings. Default true for back-compat-safe parsing by older clients.

boolean
default: true
registration_enabled
required
Registration Enabled

Whether self-service registration is open

boolean
Example
{
"allow_signup": false,
"banner_color": "warning",
"banner_enabled": false,
"banner_text": "",
"demo_mode": false,
"email_verification_required": false,
"landing_first": false,
"password_login_enabled": true
}

Bad request — invalid query parameters or payload

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Unauthorized — missing or invalid credentials

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Forbidden — caller lacks access to this resource

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Not found

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Validation error

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Too many requests — retry after the advertised interval

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}
Retry-After
integer

Seconds until the request may be retried

Internal server error

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}

Service unavailable — the database could not serve the request

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"detail": "Dataset not found",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}