---
title: "Set User Picks"
method: PUT
path: "/optimisation/user-picks"
tags: ["optimisation"]
---

# Set User Picks

`PUT /optimisation/user-picks`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/optimisation/user-picks`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Turns end-user picks on or off for a task in a workspace. On: while a new model for the
task is being tried on part of its traffic, about 2% of its non-streamed chat completions
come back with two answers, the current model's and the new one's in random order, and your
app posts which one your end user picked (POST /v1/preferences). From 1,000 picks on, the
picks decide whether the new model stays and takes all the traffic. Owners and admins.

## Request body

- UserPicksIn: Whether your app shows both answers and posts your end user's pick, for one task.
  - `workspace_id` string, uuid, required
  - `task_id` string, uuid, required
  - `enabled` boolean, required

## Response `200`

Successful Response

- UserPicks
  - `workspace_id` string, uuid, required
  - `task_id` string, uuid, required
  - `enabled` boolean, required
  - `set_by` string, required
  - `set_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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