---
title: "Set Setting"
method: PUT
path: "/workspaces/{workspace_id}/agent"
tags: ["jobs"]
---

# Set Setting

`PUT /workspaces/{workspace_id}/agent`

## 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/workspaces/{workspace_id}/agent`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Switch OS3's job agent (`enabled`), or the agents' computer (`computer`), on or off for
the workspace (each on unless switched off): an owner or admin, signed in. With the job agent
off, a run that fails or stalls gets a diagnosis only, and a session at work stops before its
next step; with the computer off, the agents' computer steps are refused and their computers
end within minutes.

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- AgentSettingIn
  - `enabled` boolean, nullable
  - `computer` boolean, nullable

## Response `200`

Successful Response

- AgentSetting: Whether OS3's job agent works on this workspace's runs that fail or stall: it reads them, cleans data into new dataset versions, changes settings and restarts runs within what was approved for them, and asks you when it needs to. `acts`: whether the agent acts on this deployment yet; until it does, every failed or stalled run gets a diagnosis only. `computer`: whether the job agent and the Copilot have their own computer here, an online box where they run commands, browse the web and read this workspace's data that OS3 copies in (on unless switched off).
  - `enabled` boolean, required
  - `acts` boolean, required
  - `computer` boolean, 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/0278b5810d1d?raw)