---
title: "Changes to Retrieve Run Settings"
method: GET
path: "/api/v1/runs/{id}/settings"
---

# Changes to Retrieve Run Settings

`GET /api/v1/runs/{id}/settings`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 19 of 134 revisions.

- **2026-08-21** `1493908ec53f` — 1 info
- **2026-08-21** `4b6d69f0b05a` — 1 breaking, 1 info
- **2026-08-21** `45581b16fce2` — 1 warning, 1 info
- **2026-08-21** `7c8b8c58f6ca` — 1 info
- **2026-08-01** `6fabbe7d611f` — 1 breaking, 1 info
- **2026-07-30** `a43c0a25e7cd` — 1 info
- **2026-07-30** `78d7c62e137d` — 1 breaking
- **2026-07-28** `356da07a11e9` — 1 warning
- **2026-07-28** `148f0a9eb912` — 1 info
- **2026-07-28** `3c01c6d3d31e` — 1 warning
- **2026-07-28** `e334b9c01456` — 1 info
- **2026-07-28** `dac168d6978b` — 1 warning
- **2026-07-01** `b7a9fdd98caf` — 1 breaking, 1 info
- **2026-06-25** `78c6acdb22fb` — 3 info
- **2026-06-14** `fbe22f7c5ef7` — 2 info
- **2026-06-13** `de85d0556040` — 2 breaking
- **2026-05-27** `d49fb1e27a21` — 2 breaking, 2 info
- **2026-05-23** `41937812f640` — 1 breaking, 2 info
- **2026-05-22** `9ffd26376217` — 1 info

## Changes

- **2026-08-21** `1493908ec53f` — 1 info
  - added the optional property `run/integrations/github/additional_repositories` to the response with the `200` status
- **2026-08-21** `4b6d69f0b05a` — 1 breaking, 1 info
  - the `run/clone/depth` response property's min was decreased from `1.00` to `0.00` for the response status `200`
  - the `depth` response's property default value `100` was added for the status `200`
- **2026-08-21** `45581b16fce2` — 1 warning, 1 info
  - removed the optional property `run/integrations/github/additional_repositories` from the response with the `200` status
  - added the optional property `run/clone/depth` to the response with the `200` status
- **2026-08-21** `7c8b8c58f6ca` — 1 info
  - added the optional property `run/integrations/github/additional_repositories` to the response with the `200` status
- **2026-08-01** `6fabbe7d611f` — 1 breaking, 1 info
  - removed the required property `run/agent/permissions` from the response with the `200` status
  - added the required property `run/agent/fabro_tools` to the response with the `200` status
- **2026-07-30** `a43c0a25e7cd` — 1 info
  - added the optional property `run/model/controls` to the response with the `200` status
- **2026-07-30** `78d7c62e137d` — 1 breaking
  - the `run/model/fallbacks` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2026-07-28** `356da07a11e9` — 1 warning
  - removed the optional property `run/hooks/items/allowed_env_vars` from the response with the `200` status
- **2026-07-28** `148f0a9eb912` — 1 info
  - added the optional property `run/hooks/items/allowed_env_vars` to the response with the `200` status
- **2026-07-28** `3c01c6d3d31e` — 1 warning
  - removed the optional property `run/hooks/items/allowed_env_vars` from the response with the `200` status
- **2026-07-28** `e334b9c01456` — 1 info
  - added the optional property `run/hooks/items/allowed_env_vars` to the response with the `200` status
- **2026-07-28** `dac168d6978b` — 1 warning
  - removed the optional property `run/hooks/items/allowed_env_vars` from the response with the `200` status
- **2026-07-01** `b7a9fdd98caf` — 1 breaking, 1 info
  - removed the required property `run/prepare/commands` from the response with the `200` status
  - added the required property `run/prepare/steps` to the response with the `200` status
- **2026-06-25** `78c6acdb22fb` — 3 info
  - added the optional property `run/agent/mcps/additionalProperties/transport/oneOf[#/components/schemas/McpTransportHttp]/protocol` to the response with the `200` status
  - added the optional property `run/agent/mcps/additionalProperties/transport/oneOf[#/components/schemas/McpTransportSandbox]/protocol` to the response with the `200` status
  - added discriminator to `run/agent/mcps/additionalProperties/transport` response property for the response status `200`
- **2026-06-14** `fbe22f7c5ef7` — 2 info
  - added the optional property `environments/additionalProperties/cwd` to the response with the `200` status
  - added the optional property `run/environment/cwd` to the response with the `200` status
- **2026-06-13** `de85d0556040` — 2 breaking
  - removed the required property `environments/additionalProperties/volumes` from the response with the `200` status
  - removed the required property `run/environment/volumes` from the response with the `200` status
- **2026-05-27** `d49fb1e27a21` — 2 breaking, 2 info
  - removed the required property `environments/additionalProperties/image/ref` from the response with the `200` status
  - removed the required property `run/environment/image/ref` from the response with the `200` status
  - added the required property `environments/additionalProperties/image/docker` to the response with the `200` status
  - added the required property `run/environment/image/docker` to the response with the `200` status
- **2026-05-23** `41937812f640` — 1 breaking, 2 info
  - removed the required property `run/sandbox` from the response with the `200` status
  - added the required property `environments` to the response with the `200` status
  - added the required property `run/environment` to the response with the `200` status
- **2026-05-22** `9ffd26376217` — 1 info
  - added the required property `run/checkpoint/skip_git_hooks` to the response with the `200` status

---

[Operation](https://skmtc.dev/fabro-sh/apis/fabro-run-api/docs/api/v1/runs/:id/settings/get.md) · [API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [Page](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/runs/:id/settings/get)