---
title: "List valid run-model options"
method: GET
path: "/org/run-models/options"
tags: ["Run Configuration"]
---

# List valid run-model options

`GET /org/run-models/options`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/run-models/options`
- Auth: API key in header `X-API-Key`

The model names (with display labels) that the run-models write accepts. Options are global, not per-org.

## Response `200`

The available run-model options.

- ModelOptionsResponse: The models the run-models write accepts, for building a picker.
  - `scope` string: The run surface these options apply to. Always `org` for this endpoint.
  - `valid_models` ModelOptionResponse[], required: The model names (with display labels) that the run-models write accepts.
    - `name` string, required: The model identifier to send when setting run models.
    - `display_name` string, required: A human-readable label for the model.

## Other responses

- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)