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

# Get Setting

`GET /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

## Path parameters

- `workspace_id` string, uuid, required

## 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/af32cd4f14bb?raw)
