---
title: "Manage desktop Stay Awake"
method: GET
path: "/api/v1/awake/observations"
tags: ["settings"]
---

# Manage desktop Stay Awake

`GET /api/v1/awake/observations`

## Request

- Base URL: `http://127.0.0.1:3001`
- URL: `http://127.0.0.1:3001/api/v1/awake/observations`
- Auth: none declared

## Response `200`

OK

- AwakeState
  - `active` boolean, required
  - `activeRules` string[], required
  - `agentOutcome` string, required
  - `capabilities` AwakeCapability[], required
    - `available` boolean, required
    - `id` string, required
    - `reason` string, required
  - `lidActive` boolean, required
  - `networkOutcome` string, required
  - `observation` AwakeObservation, required
    - `agentActive` boolean, nullable
    - `appPause` boolean, required
    - `applications` AwakeApplication[], required
      - `id` string, required
      - `identity` string, required
      - `name` string, required
      - `protected` boolean, required
    - `audioControl` boolean, required
    - `batteryPercent` integer, nullable
    - `browsers` AwakeApplication[], required
      - `id` string, required
      - `identity` string, required
      - `name` string, required
      - `protected` boolean, required
    - `devices` string[], required
    - `displayControl` boolean, required
    - `externalDisplays` integer, required
    - `keyboardControl` boolean, required
    - `knownNetworks` string[], required
    - `lowPowerAuthorized` boolean, required
    - `lowPowerControl` boolean, required
    - `lowPowerMode` boolean, required
    - `networkAddresses` string[], required
    - `networkConnected` boolean, nullable
    - `observedAt` string, date-time, required
    - `onBattery` boolean, nullable
    - `thermal` string, required
    - `uptimeSeconds` number, double, required
  - `paused` boolean, required
  - `reason` string, required
  - `rules` AwakeRule[], required
    - `conditions` AwakeCondition[], required
      - `end` string, required
      - `kind` 'agent_activity' | 'schedule' | 'power' | 'battery' | 'network' | 'device' | 'display' | 'app' | 'uptime' | 'download', required
      - `start` string, required
      - `threshold` integer, required
      - `timezone` string, required
      - `value` string, required
    - `enabled` boolean, required
    - `id` string, required
    - `lidClosed` boolean, required
    - `match` 'all' | 'any', required
    - `name` string, required
    - `suppressed` boolean, required
  - `sessions` AwakeSession[], required
    - `boundId` string, required
    - `boundIdentity` string, required
    - `createdAt` string, date-time, required
    - `deadline` string, date-time, nullable
    - `endReason` string, required
    - `endedAt` string, date-time, nullable
    - `id` string, required
    - `label` string, required
    - `lidClosed` boolean, required
    - `mode` 'indefinite' | 'duration' | 'until' | 'app' | 'download', required
    - `scope` 'ao' | 'session', required
    - `sessionId` string, required
  - `settings` AwakeSettings, required
    - `agentReconnect` boolean, required
    - `browserActions` boolean, required
    - `darkenKeyboard` boolean, required
    - `displayAwake` boolean, required
    - `hotspotName` string, required
    - `hotspotRecovery` boolean, required
    - `lidClosed` boolean, required
    - `lowPowerBatteryPercent` integer, required
    - `lowPowerOnSeriousHeat` boolean, required
    - `muteAudio` boolean, required
    - `pauseApps` string[], required
    - `restoreDisplay` boolean, required
    - `stopBatteryPercent` integer, required
  - `startedAt` string, date-time, nullable

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `501`: Not Implemented

## Changes

- **2026-10-21** `8f160e6183cd`: 3 info
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `400`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `500`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `501`
- **2026-10-17** `c80092561d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/awake/observations/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) - [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/61d7efd08578?raw)