aethexDocs
Dashboard

API Reference

Models API

Discover which LLM models are available on the platform. Use the returned identifiers in the llm_model field of POST /agents and PATCH /agents/{id}.When llm_model is empty (the default) on an agent, the platform routes that agent to a sensible default. Set an explicit model here when you want to pin behavior to a specific family.

Base URL
https://api.aethexai.com/api/v1
Endpoints
1
Scopes
models:read
GET/models

List every LLM model available to your account.

List Models

Returns the public LLM model catalog: each entry has a stable id, a human-readable name, the upstream provider, and an available flag. Pass include_unavailable=true to also see models the deployment has not configured a provider key or local endpoint for; default is false so SDK pickers only show names that will actually route.The default sentinel ("") used to mean "platform default" on an agent is hidden from this catalog; the platform-default alias surfaces as a regular entry.

Path & Query

1
  • include_unavailablebooleanoptional

    Include models whose upstream provider is not configured on this deployment. Default false.

Errors

2
401Unauthorized

Missing or invalid API key.

Send X-API-Key: '<'api_key'>'.

403Missing scope

API key lacks the models:read scope.

Issue a key with models:read.