Skip to main content
GET
List the user's Codex models

Authorizations

X-Gateway-Key
string
header
required

The caller's personal, project-scoped Aixy key. Aixy validates and removes this header before forwarding. It does not replace the ChatGPT token.

Authorization
string
header
required

The user's ChatGPT access token supplied by the official Codex client. Forwarded only to the fixed Codex backend; never stored as a connection.

Headers

X-Request-ID
string

Optional caller-generated request identifier for end-to-end tracing.

Maximum string length: 255
X-Aixy-Session-ID
string

Optional opaque conversation identifier recorded in Activity metadata. Reuse it for every call in a conversation. Sessions are isolated by organization, project, user and API key. Use no personal data or secrets. Invalid values are ignored. The header is not forwarded, grants no permissions and does not change routing affinity.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$
Example:

"conversation-82"

ChatGPT-Account-ID
string

Account/workspace selected by Codex; preserved for OpenAI validation. It does not select or authorize an Aixy tenant.

Query Parameters

client_version
string

Codex client version; forwarded unchanged.

Response

The user's native Codex model catalog.

models
object[]
required

Native Codex catalog entries including upstream capabilities, instructions and migration metadata. Forwarded without conversion to the generic OpenAI data[] catalog.