Create Session changedapi/beta/sessions/create
Nearest release: v2.1.296, published 4 hours before 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+571added
Lines−441removed
From line
237
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
The whole hunk
from line 237, old and new numbered
/
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 237
237237
238238 - `"claude-haiku-4-5"`
239239
240 Fastest model with near-frontier intelligence
241
242240 - `"claude-haiku-4-5-20251001"`
243241
244 Fastest model with near-frontier intelligence
245
246242 - `"claude-opus-4-5"`
247243
248244 Powerful intelligence for long-running agents and coding
from line 1333
13371333
13381334 - `"claude-haiku-4-5"`
13391335
1340 Fastest model with near-frontier intelligence
1341
13421336 - `"claude-haiku-4-5-20251001"`
13431337
1344 Fastest model with near-frontier intelligence
1345
13461338 - `"claude-opus-4-5"`
13471339
13481340 Powerful intelligence for long-running agents and coding
from line 1403
14111403
14121404 - `"fast"`
14131405
1414 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
1406 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
14151407
14161408 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
14171409
1418 - `type: "coordinator"`
1419
1420 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1421
1422 Full `agent` definitions the coordinator may spawn as session threads.
1423
1424 - `BetaManagedAgentsSessionThreadAgent object`
1425
1426 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
1427
1428 - `type: "agent"`
1429
1430 - `id: string`
1431
1432 - `description: string or null`
1433
1434 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1435
1436 - `type: "url"`
1410 - `BetaManagedAgentsSessionMultiagentCoordinator object`
1411
1412 Resolved coordinator topology with full agent definitions for each roster member.
1413
1414 - `type: "coordinator"`
1415
1416 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1417
1418 Full `agent` definitions the coordinator may spawn as session threads.
1419
1420 - `BetaManagedAgentsSessionThreadAgent object`
1421
1422 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
1423
1424 - `type: "agent"`
1425
1426 - `id: string`
1427
1428 - `description: string or null`
1429
1430 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1431
1432 - `type: "url"`
1433
1434 - `name: string`
1435
1436 - `url: string`
1437
1438 - `model: BetaManagedAgentsModelConfig`
1439
1440 Model identifier and configuration.
14371441
14381442 - `name: string`
14391443
1440 - `url: string`
1441
1442 - `model: BetaManagedAgentsModelConfig`
1443
1444 Model identifier and configuration.
1445
1446 - `name: string`
1447
1448 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
1449
1450 - `BetaManagedAgentsAnthropicSkill object`
1451
1452 A resolved Anthropic-managed skill.
1453
1454 - `type: "anthropic"`
1455
1456 - `skill_id: string`
1457
1458 - `version: string`
1459
1460 - `BetaManagedAgentsCustomSkill object`
1461
1462 A resolved user-created custom skill.
1463
1464 - `type: "custom"`
1465
1466 - `skill_id: string`
1467
1468 - `version: string`
1469
1470 - `system: string or null`
1471
1472 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1473
1474 - `BetaManagedAgentsAgentToolset20260401 object`
1475
1476 - `type: "agent_toolset_20260401"`
1477
1478 - `configs: array of BetaManagedAgentsAgentToolConfig`
1479
1480 - `BetaManagedAgentsBashToolConfig object`
1481
1482 Configuration for the bash tool.
1483
1484 - `type: "bash"`
1444 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
1445
1446 - `BetaManagedAgentsAnthropicSkill object`
1447
1448 A resolved Anthropic-managed skill.
1449
1450 - `type: "anthropic"`
1451
1452 - `skill_id: string`
1453
1454 - `version: string`
1455
1456 - `BetaManagedAgentsCustomSkill object`
1457
1458 A resolved user-created custom skill.
1459
1460 - `type: "custom"`
1461
1462 - `skill_id: string`
1463
1464 - `version: string`
1465
1466 - `system: string or null`
1467
1468 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1469
1470 - `BetaManagedAgentsAgentToolset20260401 object`
1471
1472 - `type: "agent_toolset_20260401"`
1473
1474 - `configs: array of BetaManagedAgentsAgentToolConfig`
1475
1476 - `BetaManagedAgentsBashToolConfig object`
1477
1478 Configuration for the bash tool.
1479
1480 - `type: "bash"`
1481
1482 - `enabled: boolean`
1483
1484 - `name: "bash"`
1485
1486 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1487
1488 Permission policy for tool execution.
1489
1490 - `BetaManagedAgentsAlwaysAllowPolicy object`
1491
1492 Tool calls are automatically approved without user confirmation.
1493
1494 - `type: "always_allow"`
1495
1496 - `BetaManagedAgentsAlwaysAskPolicy object`
1497
1498 Tool calls require user confirmation before execution.
1499
1500 - `type: "always_ask"`
1501
1502 - `BetaManagedAgentsAutoPolicy object`
1503
1504 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1505
1506 - `type: "auto"`
1507
1508 - `BetaManagedAgentsEditToolConfig object`
1509
1510 Configuration for the edit tool.
1511
1512 - `type: "edit"`
1513
1514 - `enabled: boolean`
1515
1516 - `name: "edit"`
1517
1518 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1519
1520 Permission policy for tool execution.
1521
1522 - `BetaManagedAgentsAlwaysAllowPolicy object`
1523
1524 Tool calls are automatically approved without user confirmation.
1525
1526 - `BetaManagedAgentsAlwaysAskPolicy object`
1527
1528 Tool calls require user confirmation before execution.
1529
1530 - `BetaManagedAgentsAutoPolicy object`
1531
1532 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1533
1534 - `BetaManagedAgentsReadToolConfig object`
1535
1536 Configuration for the read tool.
1537
1538 - `type: "read"`
1539
1540 - `enabled: boolean`
1541
1542 - `name: "read"`
1543
1544 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1545
1546 Permission policy for tool execution.
1547
1548 - `BetaManagedAgentsAlwaysAllowPolicy object`
1549
1550 Tool calls are automatically approved without user confirmation.
1551
1552 - `BetaManagedAgentsAlwaysAskPolicy object`
1553
1554 Tool calls require user confirmation before execution.
1555
1556 - `BetaManagedAgentsAutoPolicy object`
1557
1558 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1559
1560 - `BetaManagedAgentsWriteToolConfig object`
1561
1562 Configuration for the write tool.
1563
1564 - `type: "write"`
1565
1566 - `enabled: boolean`
1567
1568 - `name: "write"`
1569
1570 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1571
1572 Permission policy for tool execution.
1573
1574 - `BetaManagedAgentsAlwaysAllowPolicy object`
1575
1576 Tool calls are automatically approved without user confirmation.
1577
1578 - `BetaManagedAgentsAlwaysAskPolicy object`
1579
1580 Tool calls require user confirmation before execution.
1581
1582 - `BetaManagedAgentsAutoPolicy object`
1583
1584 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1585
1586 - `BetaManagedAgentsGlobToolConfig object`
1587
1588 Configuration for the glob tool.
1589
1590 - `type: "glob"`
1591
1592 - `enabled: boolean`
1593
1594 - `name: "glob"`
1595
1596 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1597
1598 Permission policy for tool execution.
1599
1600 - `BetaManagedAgentsAlwaysAllowPolicy object`
1601
1602 Tool calls are automatically approved without user confirmation.
1603
1604 - `BetaManagedAgentsAlwaysAskPolicy object`
1605
1606 Tool calls require user confirmation before execution.
1607
1608 - `BetaManagedAgentsAutoPolicy object`
1609
1610 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1611
1612 - `BetaManagedAgentsGrepToolConfig object`
1613
1614 Configuration for the grep tool.
1615
1616 - `type: "grep"`
1617
1618 - `enabled: boolean`
1619
1620 - `name: "grep"`
1621
1622 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1623
1624 Permission policy for tool execution.
1625
1626 - `BetaManagedAgentsAlwaysAllowPolicy object`
1627
1628 Tool calls are automatically approved without user confirmation.
1629
1630 - `BetaManagedAgentsAlwaysAskPolicy object`
1631
1632 Tool calls require user confirmation before execution.
1633
1634 - `BetaManagedAgentsAutoPolicy object`
1635
1636 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1637
1638 - `BetaManagedAgentsWebFetchToolConfig object`
1639
1640 Configuration for the web_fetch tool.
1641
1642 - `type: "web_fetch"`
1643
1644 - `enabled: boolean`
1645
1646 - `name: "web_fetch"`
1647
1648 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1649
1650 Permission policy for tool execution.
1651
1652 - `BetaManagedAgentsAlwaysAllowPolicy object`
1653
1654 Tool calls are automatically approved without user confirmation.
1655
1656 - `BetaManagedAgentsAlwaysAskPolicy object`
1657
1658 Tool calls require user confirmation before execution.
1659
1660 - `BetaManagedAgentsAutoPolicy object`
1661
1662 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1663
1664 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
1665
1666 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
1667
1668 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1669
1670 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
1671
1672 - `BetaManagedAgentsWebFetchURLSourceAll object`
1673
1674 Every URL from this source may be fetched. This is the default.
1675
1676 - `type: "all"`
1677
1678 - `BetaManagedAgentsWebFetchURLSourceNone object`
1679
1680 This source contributes no URLs that may be fetched.
1681
1682 - `type: "none"`
1683
1684 - `BetaManagedAgentsWebFetchURLSourceOnly object`
1685
1686 Only the named tools' results contribute URLs that may be fetched.
1687
1688 - `type: "only"`
1689
1690 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1691
1692 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
1693
1694 - `type: "tool_reference"`
1695
1696 Must be "tool_reference".
1697
1698 - `name: string`
1699
1700 Name of the tool. Compared exactly, so upper and lower case letters are different.
1701
1702 minLength: 1, maxLength: 128
1703
1704 - `BetaManagedAgentsWebFetchURLSourceExcept object`
1705
1706 Every tool's results contribute URLs that may be fetched, except the named tools' results.
1707
1708 - `type: "except"`
1709
1710 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1711
1712 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
1713
1714 - `type: "tool_reference"`
1715
1716 Must be "tool_reference".
1717
1718 - `name: string`
1719
1720 Name of the tool. Compared exactly, so upper and lower case letters are different.
1721
1722 minLength: 1, maxLength: 128
1723
1724 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1725
1726 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
1727
1728 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
1729
1730 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
1731
1732 - `BetaManagedAgentsWebFetchURLSourceAll object`
1733
1734 Every URL from this source may be fetched. This is the default.
1735
1736 - `BetaManagedAgentsWebFetchURLSourceNone object`
1737
1738 This source contributes no URLs that may be fetched.
1739
1740 - `allowed_domains: optional array of string`
1741
1742 - `blocked_domains: optional array of string`
1743
1744 - `max_content_tokens: optional number or null`
1745
1746 format: int32
1747
1748 - `BetaManagedAgentsWebSearchToolConfig object`
1749
1750 Configuration for the web_search tool.
1751
1752 - `type: "web_search"`
1753
1754 - `enabled: boolean`
1755
1756 - `name: "web_search"`
1757
1758 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1759
1760 Permission policy for tool execution.
1761
1762 - `BetaManagedAgentsAlwaysAllowPolicy object`
1763
1764 Tool calls are automatically approved without user confirmation.
1765
1766 - `BetaManagedAgentsAlwaysAskPolicy object`
1767
1768 Tool calls require user confirmation before execution.
1769
1770 - `BetaManagedAgentsAutoPolicy object`
1771
1772 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1773
1774 - `allowed_domains: optional array of string`
1775
1776 - `blocked_domains: optional array of string`
1777
1778 - `user_location: optional BetaManagedAgentsUserLocation or null`
1779
1780 Approximate user location for search result localization.
1781
1782 - `type: "approximate"`
1783
1784 Location precision. Only "approximate" is supported.
1785
1786 - `city: optional string or null`
1787
1788 City name.
1789
1790 minLength: 1, maxLength: 255
1791
1792 - `country: optional string or null`
1793
1794 Two-letter ISO 3166-1 country code, uppercase.
1795
1796 - `region: optional string or null`
1797
1798 Region or state name.
1799
1800 minLength: 1, maxLength: 255
1801
1802 - `timezone: optional string or null`
1803
1804 IANA timezone identifier, e.g. "America/Los_Angeles".
1805
1806 minLength: 1, maxLength: 255
1807
1808 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
1809
1810 Resolved default configuration for agent tools.
14851811
14861812 - `enabled: boolean`
14871813
1488 - `name: "bash"`
1489
14901814 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
14911815
14921816 Permission policy for tool execution.
from line 1819
14951819
14961820 Tool calls are automatically approved without user confirmation.
14971821
1498 - `type: "always_allow"`
1499
15001822 - `BetaManagedAgentsAlwaysAskPolicy object`
15011823
15021824 Tool calls require user confirmation before execution.
15031825
1504 - `type: "always_ask"`
1505
15061826 - `BetaManagedAgentsAutoPolicy object`
15071827
15081828 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
15091829
1510 - `type: "auto"`
1511
1512 - `BetaManagedAgentsEditToolConfig object`
1513
1514 Configuration for the edit tool.
1515
1516 - `type: "edit"`
1830 - `BetaManagedAgentsMCPToolset object`
1831
1832 - `type: "mcp_toolset"`
1833
1834 - `configs: array of BetaManagedAgentsMCPToolConfig`
15171835
15181836 - `enabled: boolean`
15191837
1520 - `name: "edit"`
1838 - `name: string`
15211839
15221840 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
15231841
from line 1853
15351853
15361854 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
15371855
1538 - `BetaManagedAgentsReadToolConfig object`
1539
1540 Configuration for the read tool.
1541
1542 - `type: "read"`
1856 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
1857
1858 Resolved default configuration for all tools from an MCP server.
15431859
15441860 - `enabled: boolean`
15451861
1546 - `name: "read"`
1547
15481862 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
15491863
15501864 Permission policy for tool execution.
from line 1875
15611875
15621876 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
15631877
1564 - `BetaManagedAgentsWriteToolConfig object`
1565
1566 Configuration for the write tool.
1567
1568 - `type: "write"`
1569
1570 - `enabled: boolean`
1571
1572 - `name: "write"`
1573
1574 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1575
1576 Permission policy for tool execution.
1577
1578 - `BetaManagedAgentsAlwaysAllowPolicy object`
1579
1580 Tool calls are automatically approved without user confirmation.
1581
1582 - `BetaManagedAgentsAlwaysAskPolicy object`
1583
1584 Tool calls require user confirmation before execution.
1585
1586 - `BetaManagedAgentsAutoPolicy object`
1587
1588 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1589
1590 - `BetaManagedAgentsGlobToolConfig object`
1591
1592 Configuration for the glob tool.
1593
1594 - `type: "glob"`
1595
1596 - `enabled: boolean`
1597
1598 - `name: "glob"`
1599
1600 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1601
1602 Permission policy for tool execution.
1603
1604 - `BetaManagedAgentsAlwaysAllowPolicy object`
1605
1606 Tool calls are automatically approved without user confirmation.
1607
1608 - `BetaManagedAgentsAlwaysAskPolicy object`
1609
1610 Tool calls require user confirmation before execution.
1611
1612 - `BetaManagedAgentsAutoPolicy object`
1613
1614 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1615
1616 - `BetaManagedAgentsGrepToolConfig object`
1617
1618 Configuration for the grep tool.
1619
1620 - `type: "grep"`
1621
1622 - `enabled: boolean`
1623
1624 - `name: "grep"`
1625
1626 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1627
1628 Permission policy for tool execution.
1629
1630 - `BetaManagedAgentsAlwaysAllowPolicy object`
1631
1632 Tool calls are automatically approved without user confirmation.
1633
1634 - `BetaManagedAgentsAlwaysAskPolicy object`
1635
1636 Tool calls require user confirmation before execution.
1637
1638 - `BetaManagedAgentsAutoPolicy object`
1639
1640 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1641
1642 - `BetaManagedAgentsWebFetchToolConfig object`
1643
1644 Configuration for the web_fetch tool.
1645
1646 - `type: "web_fetch"`
1647
1648 - `enabled: boolean`
1649
1650 - `name: "web_fetch"`
1651
1652 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1653
1654 Permission policy for tool execution.
1655
1656 - `BetaManagedAgentsAlwaysAllowPolicy object`
1657
1658 Tool calls are automatically approved without user confirmation.
1659
1660 - `BetaManagedAgentsAlwaysAskPolicy object`
1661
1662 Tool calls require user confirmation before execution.
1663
1664 - `BetaManagedAgentsAutoPolicy object`
1665
1666 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1667
1668 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
1669
1670 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
1671
1672 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1673
1674 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
1675
1676 - `BetaManagedAgentsWebFetchURLSourceAll object`
1677
1678 Every URL from this source may be fetched. This is the default.
1679
1680 - `type: "all"`
1681
1682 - `BetaManagedAgentsWebFetchURLSourceNone object`
1683
1684 This source contributes no URLs that may be fetched.
1685
1686 - `type: "none"`
1687
1688 - `BetaManagedAgentsWebFetchURLSourceOnly object`
1689
1690 Only the named tools' results contribute URLs that may be fetched.
1691
1692 - `type: "only"`
1693
1694 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1695
1696 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
1697
1698 - `type: "tool_reference"`
1699
1700 Must be "tool_reference".
1701
1702 - `name: string`
1703
1704 Name of the tool. Compared exactly, so upper and lower case letters are different.
1705
1706 minLength: 1, maxLength: 128
1707
1708 - `BetaManagedAgentsWebFetchURLSourceExcept object`
1709
1710 Every tool's results contribute URLs that may be fetched, except the named tools' results.
1711
1712 - `type: "except"`
1713
1714 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1715
1716 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
1717
1718 - `type: "tool_reference"`
1719
1720 Must be "tool_reference".
1721
1722 - `name: string`
1723
1724 Name of the tool. Compared exactly, so upper and lower case letters are different.
1725
1726 minLength: 1, maxLength: 128
1727
1728 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1729
1730 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
1731
1732 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
1733
1734 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
1735
1736 - `BetaManagedAgentsWebFetchURLSourceAll object`
1737
1738 Every URL from this source may be fetched. This is the default.
1739
1740 - `BetaManagedAgentsWebFetchURLSourceNone object`
1741
1742 This source contributes no URLs that may be fetched.
1743
1744 - `allowed_domains: optional array of string`
1745
1746 - `blocked_domains: optional array of string`
1747
1748 - `max_content_tokens: optional number or null`
1749
1750 format: int32
1751
1752 - `BetaManagedAgentsWebSearchToolConfig object`
1753
1754 Configuration for the web_search tool.
1755
1756 - `type: "web_search"`
1757
1758 - `enabled: boolean`
1759
1760 - `name: "web_search"`
1761
1762 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1763
1764 Permission policy for tool execution.
1765
1766 - `BetaManagedAgentsAlwaysAllowPolicy object`
1767
1768 Tool calls are automatically approved without user confirmation.
1769
1770 - `BetaManagedAgentsAlwaysAskPolicy object`
1771
1772 Tool calls require user confirmation before execution.
1773
1774 - `BetaManagedAgentsAutoPolicy object`
1775
1776 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1777
1778 - `allowed_domains: optional array of string`
1779
1780 - `blocked_domains: optional array of string`
1781
1782 - `user_location: optional BetaManagedAgentsUserLocation or null`
1783
1784 Approximate user location for search result localization.
1785
1786 - `type: "approximate"`
1787
1788 Location precision. Only "approximate" is supported.
1789
1790 - `city: optional string or null`
1791
1792 City name.
1793
1794 minLength: 1, maxLength: 255
1795
1796 - `country: optional string or null`
1797
1798 Two-letter ISO 3166-1 country code, uppercase.
1799
1800 - `region: optional string or null`
1801
1802 Region or state name.
1803
1804 minLength: 1, maxLength: 255
1805
1806 - `timezone: optional string or null`
1807
1808 IANA timezone identifier, e.g. "America/Los_Angeles".
1809
1810 minLength: 1, maxLength: 255
1811
1812 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
1813
1814 Resolved default configuration for agent tools.
1815
1816 - `enabled: boolean`
1817
1818 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1819
1820 Permission policy for tool execution.
1821
1822 - `BetaManagedAgentsAlwaysAllowPolicy object`
1823
1824 Tool calls are automatically approved without user confirmation.
1825
1826 - `BetaManagedAgentsAlwaysAskPolicy object`
1827
1828 Tool calls require user confirmation before execution.
1829
1830 - `BetaManagedAgentsAutoPolicy object`
1831
1832 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1833
1834 - `BetaManagedAgentsMCPToolset object`
1835
1836 - `type: "mcp_toolset"`
1837
1838 - `configs: array of BetaManagedAgentsMCPToolConfig`
1839
1840 - `enabled: boolean`
1878 - `mcp_server_name: string`
1879
1880 - `BetaManagedAgentsCustomTool object`
1881
1882 A custom tool as returned in API responses.
1883
1884 - `type: "custom"`
1885
1886 - `description: string`
1887
1888 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
1889
1890 JSON Schema for custom tool input parameters.
1891
1892 - `type: "object"`
1893
1894 - `properties: optional map[unknown] or null`
1895
1896 - `required: optional array of string or null`
18411897
18421898 - `name: string`
18431899
1844 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1845
1846 Permission policy for tool execution.
1847
1848 - `BetaManagedAgentsAlwaysAllowPolicy object`
1849
1850 Tool calls are automatically approved without user confirmation.
1851
1852 - `BetaManagedAgentsAlwaysAskPolicy object`
1853
1854 Tool calls require user confirmation before execution.
1855
1856 - `BetaManagedAgentsAutoPolicy object`
1857
1858 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1859
1860 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
1861
1862 Resolved default configuration for all tools from an MCP server.
1863
1864 - `enabled: boolean`
1865
1866 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1867
1868 Permission policy for tool execution.
1869
1870 - `BetaManagedAgentsAlwaysAllowPolicy object`
1871
1872 Tool calls are automatically approved without user confirmation.
1873
1874 - `BetaManagedAgentsAlwaysAskPolicy object`
1875
1876 Tool calls require user confirmation before execution.
1877
1878 - `BetaManagedAgentsAutoPolicy object`
1879
1880 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1881
1882 - `mcp_server_name: string`
1883
1884 - `BetaManagedAgentsCustomTool object`
1885
1886 A custom tool as returned in API responses.
1887
1888 - `type: "custom"`
1889
1890 - `description: string`
1891
1892 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
1893
1894 JSON Schema for custom tool input parameters.
1895
1896 - `type: "object"`
1897
1898 - `properties: optional map[unknown] or null`
1899
1900 - `required: optional array of string or null`
1900 - `version: number`
1901
1902 format: int32
1903
1904 - `BetaManagedAgentsAdvisor object`
1905
1906 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1907
1908 - `type: "advisor"`
1909
1910 - `model: string`
1911
1912 The advisor model id.
1913
1914 - `BetaManagedAgentsSessionMultiagent20261001 object`
1915
1916 Resolved multiagent configuration with three members, as copied to the `session` at creation.
1917
1918 - `type: "multiagent_20261001"`
1919
1920 - `advisor: BetaManagedAgentsMultiagentAdvisor`
1921
1922 Whether the session's primary thread can consult an advisor model.
1923
1924 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
1925
1926 The session's primary thread can consult `model` mid-turn.
1927
1928 - `type: "enabled"`
1929
1930 - `model: string`
1931
1932 The advisor model id.
1933
1934 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
1935
1936 The agent has no advisor.
1937
1938 - `type: "disabled"`
1939
1940 - `subagents: BetaManagedAgentsSessionMultiagentSubagents`
1941
1942 Whether the agent can spawn session threads.
1943
1944 - `BetaManagedAgentsSessionMultiagentSubagentsEnabled object`
1945
1946 The agent can spawn session threads.
1947
1948 - `type: "enabled"`
1949
1950 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1951
1952 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
1953
1954 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
1955
1956 The agent can define inline agents.
1957
1958 - `type: "enabled"`
1959
1960 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
1961
1962 The agent cannot define inline agents.
1963
1964 - `type: "disabled"`
1965
1966 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
1967
1968 Full `agent` definitions of the predefined agents, which are saved agents that this agent can spawn as session threads.
1969
1970 - `type: "agent"`
1971
1972 - `id: string`
1973
1974 - `description: string or null`
1975
1976 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1977
1978 - `model: BetaManagedAgentsModelConfig`
1979
1980 Model identifier and configuration.
19011981
19021982 - `name: string`
19031983
1904 - `version: number`
1905
1906 format: int32
1907
1908 - `BetaManagedAgentsAdvisor object`
1909
1910 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1911
1912 - `type: "advisor"`
1913
1914 - `model: string`
1915
1916 The advisor model id.
1984 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
1985
1986 - `system: string or null`
1987
1988 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1989
1990 - `version: number`
1991
1992 format: int32
1993
1994 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
1995
1996 The agent cannot spawn session threads.
1997
1998 - `type: "disabled"`
1999
2000 - `workflows: BetaManagedAgentsSessionMultiagentWorkflows`
2001
2002 Whether the agent can start workflow runs.
2003
2004 - `BetaManagedAgentsSessionMultiagentWorkflowsEnabled object`
2005
2006 The agent can start workflow runs.
2007
2008 - `type: "enabled"`
2009
2010 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2011
2012 Whether a run's plan can define inline agents, which are not saved.
2013
2014 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2015
2016 Full `agent` definitions of the predefined agents, which are saved agents that a run's plan can use.
2017
2018 - `type: "agent"`
2019
2020 - `id: string`
2021
2022 - `description: string or null`
2023
2024 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2025
2026 - `model: BetaManagedAgentsModelConfig`
2027
2028 Model identifier and configuration.
2029
2030 - `name: string`
2031
2032 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2033
2034 - `system: string or null`
2035
2036 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2037
2038 - `version: number`
2039
2040 format: int32
2041
2042 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
2043
2044 The agent cannot start workflow runs.
2045
2046 - `type: "disabled"`
19172047
19182048 - `name: string`
19192049
19202050
No line in this hunk matches that.