commit_action
ChatGPTSubmit a prepared action by its action_id. This performs the create/update on the company's estate and cannot be undone from here. Only call this after showing the user the full field set the prepare step returned and receiving their explicit approval.
get_ai_usage_breakdown
ChatGPTBreak down synced AI usage over the last N days by a chosen dimension (app, department, or actor). Admin only.
get_ai_usage_summary
ChatGPTSummary of synced AI usage over the last N days (default 30): total events, top apps and top actors. Admin only.
get_company_info
ChatGPTThe current company's name and primary domain.
get_compliance_overview
ChatGPTThe company's latest compliance posture: the most recent assessment snapshot per framework (score + evidence coverage). Read-only. Admin only.
get_department_tools
ChatGPTList the tools used by a named department.
get_departments_summary
ChatGPTList the company's departments with employee counts and how many tools each uses.
get_discovered_tools
ChatGPTList shadow/discovered tools (status = discovery), most-seen first.
get_estate_summary
ChatGPTAggregated COUNTS ONLY of the company's AI tools by status, risk, and category. Use for 'how many' questions. Do NOT use to answer 'which/what tools…' — use get_tools_by_status / get_recent_requests to list tools by name.
get_identity_count
ChatGPTCount of synced user identities for the company (total / active / disabled). Admin only.
get_recent_requests
ChatGPTList tools currently in the request/approval pipeline (any in-review status), newest first. Use for 'what's pending approval / awaiting review'.
get_request_form_options
ChatGPTThe company's new-request form as it is actually configured: which fields exist, their labels, which are required, any admin hints, and the exact choices to offer (plan tier, request type, data classifications, department names). Call this BEFORE prepare_create_tool_request so the user is offered real options instead of being asked open-ended questions.
get_request_status
ChatGPTWorkflow + approval progress for a named tool request: its current status, the workflow steps and their states, and how many approvals are still pending.
get_shadow_ai_summary
ChatGPTAggregated shadow-AI detections (promoted only): total events, top apps and actors. Admin only.
get_tool_details
ChatGPTFull metadata for one named tool: status, risk, owner, use cases, data types, request info.
get_tool_report
ChatGPTLatest vendor risk/maturity report for a named tool (scores, strengths, risks, actions).
get_tools_by_category
ChatGPTList tools in a category (fuzzy match on the tool category).
get_tools_by_risk
ChatGPTList tools at a given risk level (critical/high/medium/low).
get_tools_by_status
ChatGPTList tools in a given lifecycle status. Use for 'pending approval' (new_request/initial_review/in_review/final_review), 'active', 'decommissioned', 'discovery'.
get_vendor_timeline
ChatGPTPublished vendor timeline: curated news, security incidents, and applied report changes for the company's tools — only items Clarier has reviewed and confirmed. Use for questions like 'what's happened with vendor X lately' or 'any recent vendor incidents'.
list_my_pending_approvals
ChatGPTList approval requests currently awaiting YOUR decision (the connected user), with the tool and step. Never exposes approval links.
list_tools
ChatGPTList the company's AI tools with optional filters (status, risk level, category, or discovered/shadow only). Newest first. Use for 'which tools are …' questions.
prepare_create_tool_request
ChatGPTPrepare (do NOT submit) a request to add a new AI tool/vendor to the company's estate. Call get_request_form_options first so you can offer the user this company's real fields, hints and choices rather than asking open-ended questions. Returns an action_id plus the COMPLETE field set that will be submitted — present that to the user for confirmation, then call commit_action. Safe to call repeatedly: nothing is submitted until commit.
prepare_update_tool
ChatGPTPrepare (do NOT apply) a metadata update (owner, category, notes) for an existing tool by name. Returns an action_id plus the current and new value of each field — show the user that before/after and get their confirmation, then call commit_action. Admin only. Does NOT change status.
search_tools
ChatGPTFuzzy-search the company's AI tools by name. Returns matching tools with status/risk/owner.