Skip to content
getgeolens.com

Get Ai Status

GET
/admin/ai-status/
curl --request GET \
--url 'https://example.com/admin/ai-status/?probe=false' \
--header 'Authorization: Bearer <token>'

Return single-deployment AI status; no provider-routing policy controls (admin only).

probe
Probe

When true, run a minimal LIVE provider call per purpose (chat + embeddings) to verify the configured key actually works. Costs a real provider API call — never enabled by dashboards.

boolean

When true, run a minimal LIVE provider call per purpose (chat + embeddings) to verify the configured key actually works. Costs a real provider API call — never enabled by dashboards.

Successful Response

Media type application/json
AIStatusResponse
object
configured
required
Configured

Whether an API key is configured. AI features require both ‘enabled’ and ‘configured’.

boolean
enabled
required
Enabled

Whether AI features are enabled for this instance.

boolean
has_embeddings
Has Embeddings

Whether at least one record has embeddings stored.

boolean
model
required
Any of:
string
probe
Any of:
AIProbeReport

Per-purpose live provider probe results (admin ai-status ?probe=true).

object
chat
required
AIProbeCheck

Result of one live provider check (chat or embeddings).

object
configured
required
Configured

Whether this purpose has a provider key configured. False means no probe call was made.

boolean
error
Any of:
string
ok
Any of:
boolean
status
Any of:
integer
embeddings
required
AIProbeCheck

Result of one live provider check (chat or embeddings).

object
configured
required
Configured

Whether this purpose has a provider key configured. False means no probe call was made.

boolean
error
Any of:
string
ok
Any of:
boolean
status
Any of:
integer
provider
required
Any of:
string
semantic_search_enabled
Semantic Search Enabled

Whether pgvector-backed semantic search is enabled.

boolean
Example
{
"has_embeddings": false,
"semantic_search_enabled": false
}

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