---
title: "Get the settings for members' agents"
method: GET
path: "/v1/org/workbot-settings/proactive"
tags: ["Organizations"]
---

# Get the settings for members' agents

`GET /v1/org/workbot-settings/proactive`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/org/workbot-settings/proactive`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns how members' agents work in this organization (Manage › Workbot): whether they are on, working hours, the daily limit per member, whether members start opted in, the default place messages go (a DM from the Workbot Slack app), and the current "Your agent" template version (responsibilities and organization instructions). Also says whether the Workbot Slack app is installed to send those DMs and whether the headless runner the agents run on is configured. Requires the workbotProactive feature, Workbot on this deployment, and View OpenWork Models settings or Manage OpenWork Models.

## Response `200`

Agent settings returned.

- WorkbotProactiveSettings
  - `settings` object, required
    - `enabled` boolean, required
    - `leadMinutes` integer, required
    - `workingDays` 'weekdays' | 'everyday', required
    - `startHour` integer, required
    - `endHour` integer, required
    - `dailyCap` integer, required
    - `membersStart` 'opted_in' | 'opted_out', required
    - `destination` 'workbot_dm', nullable, required
  - `template` object, required
    - `responsibilities` object, required
      - `morning_brief` boolean, required
      - `meeting_prep` boolean, required
      - `calendar_changes` boolean, required
      - `waiting_on_you` boolean, required
    - `instructions` string, required
    - `versionId` string, nullable, required
    - `version` integer, required
  - `slackReady` boolean, required
  - `runnerReady` boolean, required

## Other responses

- `401`: Authentication required.
- `403`: The caller lacks both View OpenWork Models settings and Manage OpenWork Models.
- `404`: The organization was not found, or Workbot is off.

## Changes

- **2026-10-27** `2badfe0bc939`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/org/workbot-settings/proactive/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8117bc7c5626?raw)