---
title: "Subscribe to Agent Sessions"
method: PUT
path: "/api/v4/{workspace-slug}/agent-sessions/subscription"
---

# Subscribe to Agent Sessions

`PUT /api/v4/{workspace-slug}/agent-sessions/subscription`

## Request

- Base URL: `https://api.app.shortcut.com`
- URL: `https://api.app.shortcut.com/api/v4/{workspace-slug}/agent-sessions/subscription`
- Auth: HTTP bearer

Opt the authenticated agent installation into session events instead of legacy interaction webhooks.

## Path parameters

- `workspace-slug` string, required

## Request body

- Body2522638
  - `enabled` boolean, required: Enable or disable session events for this installation.

## Response `200`

Resource

- Subscription
  - `enabled` boolean, required
  - `enabled_after_t` integer, required
  - `enabled_at` string, date-time, required
  - `installation_id` string, uuid, required
  - `workspace_id` string, uuid, required

## Other responses

- `400`: Schema mismatch
- `403`: **Either:** (1) Resource does not exist **or** (2)
- `404`: **Either:** (1) Resource does not exist **or** (2)
- `409`: **Either:** (1) Resource does not exist **or** (2)
- `422`: **Either:** (1) Resource does not exist **or** (2)
- `429`: **Either:** (1) Resource does not exist **or** (2)
- `503`: **Either:** (1) Resource does not exist **or** (2)

## Changes

- **2026-10-15** `46322a38c246`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shortcut-com/apis/shortcut-api/changes/api/v4/:workspace-slug/agent-sessions/subscription/put.md)

---

[API](https://skmtc.dev/shortcut-com/apis/shortcut-api.md) · [All operations](https://skmtc.dev/shortcut-com/apis/shortcut-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortcut-com/apis/shortcut-api/revisions/19f70025330b?raw)