Skip to main content
POST
Add an AI catalog model

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
key
string
required
display_name
string
required
model_id
string
required
description
string
endpoint_id
string<uuid> | null

A custom endpoint that serves the model; empty or null for the Ankra provider.

tier
string
context_window_tokens
integer

0 uses the default.

max_output_tokens
integer

0 uses the default.

supports_tools
boolean
default:true
supports_thinking
boolean
default:false
supports_images
boolean
default:false
is_enabled
boolean
default:true
sort_order
integer

Response

The created model

One entry of the organisation's AI model catalog.

id
string<uuid> | null
required

Row id; null for a built-in default that has not been materialised.

key
string
required
display_name
string
required
description
string
required
provider
string
required

ankra, or openai_compatible when the model is served by a custom endpoint.

endpoint_id
string<uuid> | null
required
model_id
string
required
tier
string | null
required
context_window_tokens
integer
required
max_output_tokens
integer
required
supports_tools
boolean
required
supports_thinking
boolean
required
supports_images
boolean
required
is_enabled
boolean
required
sort_order
integer
required
is_default
boolean
required