---
title: "Set the org's run models"
method: PUT
path: "/org/run-models"
tags: ["Run Configuration"]
---

# Set the org's run models

`PUT /org/run-models`

## Request

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

Replaces the organization's run models with the given set. Every option from `GET /org/run-models/options` is valid (matching is case-insensitive, and a few legacy alias spellings are also accepted); an unsupported name returns 400 with the list of unsupported and valid models. Setting run models also replaces the scheduler-models opt-in (`/org/scheduler-models`) with the equivalent scheduler models.

## Request body

- SetOrgRunModelsRequest
  - `models` string[], required: The bare model names to run, e.g. `chatgpt`, `gemini`, `claude`. The valid set is derived from the model registry (admin-configurable), so fetch it from GET /org/run-models/options rather than hard-coding it; an unsupported name returns 400.

## Response `200`

The updated run models.

- OrgRunModelsResponse
  - `models` OrgRunModelItem[], required: The AI models this org's runs currently execute against.
    - `geo_model_id` string, uuid, required: The model's id.
    - `name` string, required: The model name.
    - `created_at` string, date-time, required: When this model was added to the org's run set.
    - `updated_at` string, date-time, required: When this model entry was last updated.

## Other responses

- `400`: The request body was invalid (`ValidationErrorResponse` or `ErrorResponse`), or one or more requested models are not supported (`UnknownModelsResponse`, which lists the unsupported and valid models).
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.

---

[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)