Lists the models and effort levels that the installed tool or bound provider of one provider profile reports now, cached for two minutes; it sends no prompt, starts no conversation and returns no credential.

GET

/v1/m/sessions/provider-profiles/{ref}/models

curl --request GET \
  --url https://example.com/v1/m/sessions/provider-profiles/example/models \
  --header 'Authorization: Bearer <token>'

• this engine

Lists the models and effort levels that the installed tool or bound provider of one provider profile reports now, cached for two minutes; it sends no prompt, starts no conversation and returns no credential.

Authorizations

• bearerAuth
• browserSession

Parameters

Path Parameters

ref

required

string

Path parameter ref.

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Query Parameters

refresh

boolean

Refresh the upstream catalog now.

Responses

200

Live catalog from the profile’s installed tool or bound provider. Cached per profile for two minutes; refresh=true bypasses the cache. Free text remains available. Vendor errors, paths and credentials are never returned.

Media type application/json

object

checked_at

required

string format: date-time

default_model

required

Empty selects the installed tool’s own default. Optional model markers and capabilities are present only when the tool reports them.

string

driver

required

string

free_text

required

boolean

message

string

models

required

Array<object>

<= 1000 items

object

default_effort

string

display_name

string

effort_levels

Array<string>

<= 32 items

id

required

string

is_default

boolean

is_legacy

boolean

is_new

boolean

service_tiers

Array<string>

<= 32 items

supports_fast_mode

boolean

profile_ref

required

string

refresh_interval_seconds

required

integer

state

required

string

Allowed values: fresh unsupported failed

Example

{
  "state": "fresh"
}

400

Invalid profile reference or refresh query

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Profile read permission required

Media type application/json

object

Example ^generated

{}

404

Profile absent in this tenant

Media type application/json

object

Example ^generated

{}

409

Profile unavailable or changed during discovery

Media type application/json

object

Example ^generated

{}

422

Profile driver or authentication source is unavailable

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}

500

Store or audit failure

Media type application/json

object

Example ^generated

{}

503

Required runtime wiring is unavailable

Media type application/json

object

Example ^generated

{}