Skip to content
getgeolens.com

Validate Configuration

POST
/config-ops/validate/
curl --request POST \
--url https://example.com/config-ops/validate/ \
--header 'Authorization: Bearer <token>'

Validate connectivity to storage, cache, and all enabled OIDC providers.

Returns pass/fail with latency and error details for each service.

Successful Response

Media type application/json
ConnectivityResult

Aggregate connectivity validation result.

object
cache
required
ServiceProbeResult

Cache backend probe result.

object
error
Any of:
string
latency_ms
required
Latency Ms

Round-trip latency in milliseconds.

number
name
required
Name

Service name (e.g. ‘storage’, ‘cache’, ‘oidc:google’).

string
status
required
Status

Probe outcome.

string
Allowed values: ok error
oidc_providers
required
Oidc Providers

Per-provider OIDC discovery probe results, keyed by provider slug.

object
key
additional properties
ServiceProbeResult

Result of a single service connectivity probe.

object
error
Any of:
string
latency_ms
required
Latency Ms

Round-trip latency in milliseconds.

number
name
required
Name

Service name (e.g. ‘storage’, ‘cache’, ‘oidc:google’).

string
status
required
Status

Probe outcome.

string
Allowed values: ok error
storage
required
ServiceProbeResult

Object storage probe result.

object
error
Any of:
string
latency_ms
required
Latency Ms

Round-trip latency in milliseconds.

number
name
required
Name

Service name (e.g. ‘storage’, ‘cache’, ‘oidc:google’).

string
status
required
Status

Probe outcome.

string
Allowed values: ok error
Example
{
"cache": {
"status": "ok"
},
"oidc_providers": {
"additionalProperty": {
"status": "ok"
}
},
"storage": {
"status": "ok"
}
}

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"
}