status
Verify your API key resolves to a workspace and inspect the workspace’s current state. Use this to debug “why isn’t my call working” before reaching for support.
GET /v1/status
Free diagnostic. Does not count against any plan quota. Suspended and limit-reached workspaces still receive a 200 so you can see why other calls are failing.
Request
curl https://api.mnemexa.com/v1/status \
-H "Authorization: Bearer mnx_ws_YOUR_KEY"No request body. Workspace is derived from the API key.
Response
{
"workspace_id": 42,
"workspace_name": "Acme Production",
"workspace_status": "active",
"plan_name": "Growth",
"billing_cycle": "monthly",
"api_key_id": 17,
"api_key_prefix": "mnx_ws_ab12345",
"healthy": true,
"server_time": "2026-05-15T18:30:00Z"
}Fields
| Field | Type | Description |
|---|---|---|
workspace_id | integer | Numeric identifier for the workspace. |
workspace_name | string | Display name set in the dashboard. |
workspace_status | string | One of active, pending_payment, suspended, limit_reached. |
plan_name | string | null | The active plan, e.g. Free, Starter, Growth. null if no subscription is attached. |
billing_cycle | string | null | monthly or yearly. null when plan_name is null. |
api_key_id | integer | Numeric identifier for the API key used in this request. |
api_key_prefix | string | First 14 characters of the key (e.g. mnx_ws_ab12345). Lets you confirm which key the SDK loaded. |
healthy | boolean | Always true on a 200 response. Future-proofing — clients should treat any other value as “degraded”. |
server_time | string | ISO 8601 UTC timestamp. Useful for clock-skew diagnostics. |
Interpreting workspace_status
| Status | What it means | What other endpoints do |
|---|---|---|
active | Normal operating state. | All calls accepted. |
pending_payment | Initial signup, awaiting first payment confirmation. | Most calls accepted; some plan-gated features may not be available yet. |
suspended | Admin or billing intervention. | Memory store/retrieve return 403. status and optimize.health continue to work for diagnostics. |
limit_reached | Plan’s per-cycle unit cap exhausted. | Memory store/retrieve return 429. status and optimize.health continue to work. |
Errors
| Status | Cause |
|---|---|
| 401 | Missing or invalid Authorization header. |
| 403 | API key disabled, workspace deleted, or client account suspended. |
A 401 means the key string itself isn’t recognized. A 403 means the key is recognized but inactive. The 200 response itself never indicates a problem — inspect workspace_status to see whether the workspace is in a non-active state.
SDKs
import mnemexa
client = mnemexa.Client()
status = client.status()
print(f"Connected to {status.workspace_name} ({status.workspace_status})")
print(f"Plan: {status.plan_name} / {status.billing_cycle}")
print(f"Key: {status.api_key_prefix}")The MCP adapter exposes this as brain.status. See Python SDK and MCP Adapter.