Skip to main content

​
Usage Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/usage/summaryBearer tokenHigh-level usage, limits, and wallet
GET/api/agents/v1/usage/productsBearer tokenProduct-wise plan limits/remaining
GET/api/agents/v1/usage/historyBearer tokenUsage timeline (from, to, limit)
Usage history query parameters:
  • from (optional, date)
  • to (optional, date)
  • limit (optional, integer, max 200)

​
Agent Model Discovery Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/modelsBearer tokenSearch/filter paginated model catalog
GET/api/agents/v1/models/filtersBearer tokenFilter metadata (sorts/types/base models/features)
GET/api/agents/v1/models/tagsBearer tokenActive model tags
GET/api/agents/v1/models/providersBearer tokenProviders list
GET/api/agents/v1/models/{modelId}Bearer tokenModel details (includes parameters JSON Schema)
The model detail endpoint returns endpoint configurations with a parameters object — a JSON Schema describing each endpoint’s accepted parameters (types, constraints, defaults, enums). This provides a clean, machine-readable alternative to the raw UI config array. Common model query parameters:
  • feature
  • search
  • model_type
  • model_subcategory
  • base_model
  • provider
  • sort (recommended, latest, most-used, asc, desc, sort-asc, sort-desc)
  • per_page
  • tags (array or comma-separated)

​
Example

​
Generic Model Discovery under Existing API Key Flow

These endpoints are available for existing API-key users as well:
MethodEndpointAuth
GET/api/v6/model-searchAPI key (key)
GET/api/v6/model-search/filtersAPI key (key)
GET/api/v6/model-search/tagsAPI key (key)
GET/api/v6/model-search/providersAPI key (key)
GET/api/v6/model-search/{modelId}API key (key)
Example:

Related topics

Agents API (Control Plane)UsageModelsLab Agent Skills