---
title: "Get my agent"
method: GET
path: "/v1/me/agent"
tags: ["Users"]
---

# Get my agent

`GET /v1/me/agent`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/me/agent`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

The signed-in member's own agent in the active organization: whether it is on for them, what it will tell them about (each responsibility, whether the organization turned it on and whether they muted it), where its messages go (a DM from the Workbot Slack app) and whether they can arrive yet (the Slack app installed, their Slack account linked), the working hours and daily limit it follows, and when it looks next. With My agent on (workbotAgentLibrary) it also says what it did: `lastCheck` and `todayChecks` (each with an outcome sent, quiet, waited or failed, and a `summary` sentence that says why, for example "Stayed quiet: nothing new." or "Couldn't read Gmail: reconnect Google."), `sentToday` against `limits.dailyCap`, the member's own words (`preferences`: always, never, when, how), their narrower `limits` inside the admin's, and their recent `changes`. Answer "why was it quiet?" from these records, never by guessing. Requires the workbotProactive feature and Workbot on this deployment.

## Response `200`

The member's agent.

- MemberAgent
  - `available` boolean, required
  - `on` boolean, required
  - `snoozedUntil` string, date-time, nullable, required
  - `responsibilities` object[], required
    - `id` 'morning_brief' | 'meeting_prep' | 'calendar_changes' | 'waiting_on_you', required
    - `label` string, required
    - `tells` string, required
    - `enabled` boolean, required
    - `muted` boolean, required
  - `destination` object, nullable, required
    - `kind` 'workbot_dm', required
    - `name` string, required
    - `blocked` 'slack_app_not_installed' | 'member_not_linked', nullable, required
  - `workingHours` object, required
    - `workingDays` 'weekdays' | 'everyday', required
    - `startHour` number, required
    - `endHour` number, required
    - `dailyCap` number, required
  - `nextCheckAt` string, date-time, nullable, required
  - `timeZone` string
  - `lastCheck` object, nullable
    - `id` string, required
    - `at` string, date-time, required
    - `kind` 'morning' | 'scheduled' | 'calendar', required
    - `outcome` 'sent' | 'quiet' | 'waited' | 'failed', required
    - `reason` 'sent' | 'nothing_new' | 'already_told' | 'unreadable_reply' | 'daily_limit' | 'nothing_to_check' | 'outside_hours' | 'quiet_window' | 'snoozed' | 'google_disconnected' | 'slack_app_not_installed' | 'member_not_linked' | 'no_destination' | 'send_failed' | 'agent_unavailable', required
    - `headline` string, required
    - `summary` string, required
    - `responsibilities` string[], required
    - `slackUrl` string, nullable, required
    - `fix` 'reconnect_google' | 'link_slack' | 'ask_admin', nullable, required
  - `todayChecks` object[]
    - `id` string, required
    - `at` string, date-time, required
    - `kind` 'morning' | 'scheduled' | 'calendar', required
    - `outcome` 'sent' | 'quiet' | 'waited' | 'failed', required
    - `reason` 'sent' | 'nothing_new' | 'already_told' | 'unreadable_reply' | 'daily_limit' | 'nothing_to_check' | 'outside_hours' | 'quiet_window' | 'snoozed' | 'google_disconnected' | 'slack_app_not_installed' | 'member_not_linked' | 'no_destination' | 'send_failed' | 'agent_unavailable', required
    - `headline` string, required
    - `summary` string, required
    - `responsibilities` string[], required
    - `slackUrl` string, nullable, required
    - `fix` 'reconnect_google' | 'link_slack' | 'ask_admin', nullable, required
  - `sentToday` integer
  - `preferences` object
    - `always` string, required
    - `never` string, required
    - `when` string, required
    - `how` string, required
  - `limits` object
    - `workingDays` 'weekdays' | 'everyday', required
    - `startHour` integer, required
    - `endHour` integer, required
    - `dailyCap` integer, required
    - `quietWindow` object, nullable, required
      - `startHour` integer, required
      - `endHour` integer, required
    - `admin` object, required
      - `startHour` integer, required
      - `endHour` integer, required
      - `dailyCap` integer, required
    - `narrowed` object, required
      - `hours` boolean, required
      - `dailyCap` boolean, required
  - `changes` object[]
    - `id` string, required
    - `field` 'always' | 'never' | 'when' | 'how' | 'hours' | 'dailyCap' | 'quietWindow' | 'morning_brief' | 'meeting_prep' | 'calendar_changes' | 'waiting_on_you', required
    - `summary` string, required
    - `source` 'chat' | 'page', required
    - `at` string, date-time, required
    - `undone` boolean, required
  - `link` string

## Other responses

- `401`: The caller must be signed in.
- `404`: Agents are off for this organization.

## Changes

- **2026-10-27** `9fa47a73a88e`: 8 info
  - added the optional property `changes` to the response with the `200` status
  - added the optional property `lastCheck` to the response with the `200` status
  - added the optional property `limits` to the response with the `200` status
  - added the optional property `link` to the response with the `200` status
  - …4 more
- **2026-10-27** `2badfe0bc939`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/me/agent/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)