Follow Discord
Sweep 06 Nov 2026 · 01:32Z Build v2.1.319 537 read Stable v2.1.311 Latest v2.1.319 Next v2.1.319 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 21 Sep 2026
One change · api

Events changedapi/beta/sessions/events

Nearest release: v2.1.280, published 20 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+12added
Lines−2removed
From line 43 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits29to this page, all time

The whole hunk

from line 43, old and new numbered
/
lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 43
4343 
4444- `limit: optional number`
4545 
46 Query parameter for limit
47 
4846 format: int32
4947 
5048- `order: optional "asc" or "desc"`
from line 165
167165 
168166- `"anthropic-workspace-id": optional string`
169167 
168 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
169 
170 Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
171 
170172### Returns
171173 
172174- `data: optional array of BetaManagedAgentsSessionEvent`
from line 2560
25582560 
25592561- `"anthropic-workspace-id": optional string`
25602562 
2563 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
2564 
2565 Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
2566 
25612567### Body parameters
25622568 
25632569- `events: array of BetaManagedAgentsEventParams`
from line 3541
35353541 
35363542- `"anthropic-workspace-id": optional string`
35373543 
3544 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
3545 
3546 Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
3547 
35383548### Returns
35393549 
35403550- `BetaManagedAgentsStreamSessionEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 8995
89858995 - `BetaManagedAgentsUserToolConfirmationEvent object`
89868996 
89878997 A tool confirmation event that approves or denies a pending tool execution.
8988 
8989 - `type: "user.tool_confirmation"`
8990 
8991 - `id: string`
8992 
8993 Unique identifier for this event.
8994 
8995 - `result: "allow" or "deny"`
8996 
8997 UserToolConfirmationResult enum
8998 
8999 - `"allow"`
9000 
9001 - `"deny"`
9002 
9003 - `tool_use_id: string`
9004 
9005 The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
9006 
9007 - `deny_message: optional string or null`
9008 
9009 Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.
9010 
9011 maxLength: 10000
9012 
9013 - `processed_at: optional string or null`
9014 
9015 A timestamp in RFC 3339 format
9016 
9017 format: date-time
9018 
9019 - `session_thread_id: optional string or null`
9020 
9021 Set by the serve
Feedback