---
title: "Get Optimizer"
method: GET
path: "/optimisation/optimizer"
tags: ["optimisation"]
---

# Get Optimizer

`GET /optimisation/optimizer`

## 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/optimizer`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Whether OS3's optimizer agent works on the workspace's tasks.

## Query parameters

- `workspace_id` string, uuid, required

## Response `200`

Successful Response

- OptimizerSetting: OS3's optimizer agent in a workspace, a preview you opt into (off unless switched on): for each task it plans and runs bounded training experiments within the task's mandate, and hands its best candidate to the same independent evaluation and release checks as every other candidate; it never sees the held-out cases that decide a release. `available`: whether the preview runs for your organisation yet; until it does, your choice is kept and nothing runs.
  - `workspace_id` string, uuid, required
  - `enabled` boolean, required
  - `available` boolean, required
  - `set_by` string, nullable, required
  - `set_at` string, date-time, nullable, 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)