Skip to content

Capabilities

The capabilities endpoint returns a quick summary of what the gateway can currently do — which inference types are available, how many nodes are connected, and which routing strategy is active.

This is useful for checking gateway health before making inference requests, or for displaying a status indicator in an integration.

Endpoint

GET /optima/v1/capabilities

Requires authentication. See Authentication.

Response

{
  "canChat": true,
  "canEmbed": false,
  "numNodes": 2,
  "routing": "RoundRobin"
}
Field Type Description
canChat boolean true if at least one node has a chat model running.
canEmbed boolean true if at least one node has an embedding model running.
numNodes integer Number of nodes currently connected to the gateway.
routing string The active routing strategy configured on the gateway (e.g. "RoundRobin").

Status codes

Code Meaning
200 Success
401 Not authenticated
503 Gateway not ready