Represents a minimal summary of an action.
| Field | Type | Required | Description |
|---|---|---|---|
tool_id |
str | ✔️ | The unique identifier of the action. |
display_name |
str | ✔️ | The display name of the action. |
type |
Optional[str] | ➖ | The type of tool - RETRIEVAL for read-only operations, ACTION for operations that modify data. |
auth_type |
Optional[str] | ➖ | The authentication type required - OAUTH_USER, OAUTH_ADMIN, API_KEY, BASIC_AUTH, DWD (domain-wide delegation), or NONE. |
write_action_type |
Optional[str] | ➖ | For write actions only - REDIRECT (client renders URL) or EXECUTION (external server call). |
is_setup_finished |
Optional[bool] | ➖ | Whether this action has been fully configured and validated. |
data_source |
Optional[str] | ➖ | Indicates the kind of knowledge a tool would access or modify. Company knowledge: - Glean search, and any native tools that derive from it (e.g., expert search, code search) - Native federated tools to company data sources (e.g., outlook search) World knowledge: - Platform action like bravewebsearch, geminiwebsearch, etc Neutral knowledge: - Native tools that don't access or modify content via APIs (e.g., file analyst, think) - Platform read or write tools (creator has to determine their knowledge implications) |