Models API

List the available Carrier Modes. This is the source of truth for the mode values accepted by the Chat API.

GET/v1/models

Authentication

Requires a secret API key passed as a Bearer token (Authorization: Bearer carrier_sk_…).

Example request

bash

curl https://api.carrieros.ai/v1/models -H "Authorization: Bearer carrier_sk_live_YOUR_KEY"

Response

Field	Type	Description
[].id	string	Mode id: general, developer, or research.
[].name	string	Human-readable name.
[].description	string	What the mode is best suited for.

Example response

json

{
  "success": true,
  "data": [
    { "id": "general",   "name": "General Assistant",   "description": "Everyday questions and general-purpose help." },
    { "id": "developer", "name": "Developer Assistant", "description": "Coding, debugging, and technical problem-solving." },
    { "id": "research",  "name": "Research Assistant",  "description": "In-depth research, analysis, and synthesis." }
  ]
}

Notes

Only Carrier Modes are returned — underlying providers are never exposed.