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

# Set the org's scheduler models

`PUT /org/scheduler-models`

## Request

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

Replaces the organization's scheduler model opt-in. Each model is validated against the models the scheduler supports; an unsupported entry returns 400 with the list of unsupported and valid models.

## Request body

- SetModelsRequest
  - `models` string[], required: The `provider/model` identifiers to opt the scheduler into, e.g. `anthropic/claude`. The supported set is configurable, so do not hard-code it: an unsupported entry returns 400 listing every value that is accepted.

## Response `200`

The updated scheduler models.

- ModelListResponse: The models in an owner's opt-in set.
  - `models` ModelResponse[], required: The models the scheduler runs for this org.
    - `id` string, uuid, required: The model's id.
    - `provider` string, required: The model provider (e.g. `openai`).
    - `model` string, required: The provider's model identifier.
    - `execution_mode` 'batch_async' | 'single_sync', required: How the model is executed by the scheduler.
    - `adapter_key` string, required: The adapter key the platform uses to run this model.

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