fetch
ChatGPTRead in full one document search returned, by its ID (such as initiative:42 or help:7): an initiative's figures, a metric's definition, a connection's health, a template or a help article.
get_assumptions
ChatGPTThe account's assumptions: the figures its formulas price with, such as a loaded hourly labor rate, a cost per deflected ticket or a contribution margin, as the Assumptions page lists them. Each gives the figure in force today with its unit (money is US dollars, unless an account typed a unit naming another currency, which nothing converts), whether it is the account's own or Roiva's unconfirmed default, who set it and when, whether it stands in for a figure nobody has measured, and how many formulas and initiatives read it. Pass input_key for one assumption in full: what it measures, its basis or source, every dated figure by period with who set each and why, and each formula reading it. Use these figures, not rates of your own, when estimating with this account's numbers. A share of an outcome's change credited to one initiative is that initiative's own: get_formula shows it.
get_connection_health
ChatGPTOne integration connection's health: whether it needs to be reconnected, its latest error, and what its last few syncs did (records brought in, skipped and failed, and why). Use it for "why isn't my data coming in" and "did the sync work". Get the ID from list_integrations.
get_cost_breakdown
ChatGPTThe cost entries behind an initiative's total cost, newest first, with the sum computed for you: each entry's period, type, capex or opex, amount in dollars, vendor, source and notes; totals by type and category; and anything counted at a provisional rate or left out for want of one. Pass month (YYYY-MM) for one month.
get_entry_history
ChatGPTWhat happened to one value entry, cost entry or reading: who recorded, edited and approved it, who can approve a value entry not counted yet ("you" is the user) or what has to happen first, the approval decisions and reasons, inputs that changed since it was calculated, and, for an Admin or Owner on a plan with the audit log, its audit log rows. Pass the entry's ID from get_value_breakdown or get_cost_breakdown.
get_formula
ChatGPTThe value formulas live on an initiative: each one's expression, the type of value it books, and every input with what it reads today (the latest reading, the baseline with its method and when it was set, or the assumption and who set it) and the figure it last used. Use it for "how is this calculated", "what baseline is it using" and "how do I change the baseline". For a template's formulas before an initiative uses them, use get_template.
get_help_article
ChatGPTFetch the full text of a published Roiva help article: how the product works, where things are and who can do them. Pass its slug (the last part of an article's /docs/ URL, or from the help index where you have one) or its ID, as search_roiva and search_help return it. A /docs/reference/ page is generated, not an article, and this can't fetch it.
get_initiative
ChatGPTGet detailed information about a single initiative: stage, category, owner, expected financials (its business case), its approved budget against spend to date, and recent costs/value entries/notes.
get_metric
ChatGPTOne metric's definition: what it counts, its unit, why a formula asks for it where that isn't obvious, what to watch out for and the help article that goes further. Pass its metric key (such as cloud.usage.unit_count) or the ID search_roiva returns.
get_plan_vs_actual
ChatGPTHow the business cases of initiatives that went live (including any since paused, completed or dismissed) compare with what they delivered: for each, its planned figures (CapEx, OpEx and value per period, freed capacity), the plan to date beside approved actuals to date for cash value, freed capacity and cost, cash ROI actual and planned to date, how long it has been live, time to first value against its target, what its value rests on, and what was left out for want of an exchange rate. Cash value against plan is judged as ROI › Initiatives judges it (behind, on plan, ahead, or why not yet). Cash and freed capacity are separate figures, never added. Use it for "how far off were our earlier business cases" before estimating a new one. Filter by category or template_id (from search_roiva, types: templates).
get_platform_setup_guide
ChatGPTThe guide for connecting one platform to Roiva (Zendesk, HubSpot, AWS, GitHub, QuickBooks…), as the connect form shows it: how it connects, the steps, where to find the credential, any setup script, tips, whether this account has connected it, and the page to connect it from. Use it for any "how do I connect X" question.
get_roi_summary
ChatGPTGet the actual ROI rollup — cash value and freed capacity (approved entries, two figures never added), cost, net cash, cash ROI %, capex/opex split, with the URL of the ROI page that shows them. Pass initiative_id for a single initiative; omit for the whole portfolio.
get_template
ChatGPTOne initiative template from the library: what it is for, its hypothesis, ratings, the financial defaults it prefills (Roiva's typical figures, not this account's), what it counts as cost, and the value formulas it ships, with the metrics each one reads and why. Use it for "why does this template use X" or "what does it measure". Find the ID with search_roiva (types: templates) or from a template page's URL.
get_value_breakdown
ChatGPTThe value entries behind an initiative's value figure, newest first, with the sum computed for you. Each entry gives its period, type (cash or freed capacity), amount, status, whether it counts, what it rests on, the formula and every input it was calculated from, notes about those inputs, readings that changed since, and who approved it. An entry not counted yet says who can approve it now ("you" is the user), or what has to happen before anyone can; repeat that rather than guessing at the approval rules. Totals are counted as the ROI page counts them, for that month or all periods (not a reporting period), plus what is not counted yet. Use it for "how does this figure tie", "why is this month lower" and "what is in this number". Pass month (YYYY-MM) for one month; omit it for all periods.
list_initiatives
ChatGPTList AI initiatives for the current account. Returns id, title, stage, and status. Optionally filter by status.
list_integrations
ChatGPTList the account's integration connections, with platform, status, last sync time, whether one needs to be reconnected, and its latest error. For why one isn't bringing data in, use get_connection_health.
list_my_proposals
ChatGPTThe changes you have drafted for a person to accept in Roiva, newest first: each one's status (waiting, accepted, declined with the reason given, withdrawn, expired or superseded), who decided it, and its page in Roiva.
list_requested_readings
ChatGPTThe monthly figures Roiva is asking a person to type in, because no connected system reports them: for each, the initiative, the metric key and its name, the month it is asked for (YYYY-MM; a month's total is asked once the month has ended), its unit, where to find it, and any proposal already waiting. Use it before propose_reading. For an initiative recorded as live from an earlier date, it also lists the months since then that still take a figure (the initiative's Past months page in Roiva); draft those with propose_past_readings.
propose_costs
ChatGPTDraft the charges on one vendor bill Roiva doesn't connect to (an invoice, receipt or usage export you can see) as costs on an initiative, for a person to review and book in Roiva. Nothing in Roiva changes until they book it there; the costs they book then count toward ROI at once, so say plainly that it is only a draft. Roiva checks each line against what the initiative already books (its cost connections, vendor mappings, entries and locked months) and says which may count twice or can't be booked. Amounts are in the bill's currency; Roiva books US dollars only. At most 50 lines, and the call must stay under 16 KB, so keep descriptions and quotes short and propose a longer bill in parts (a month at a time), giving each part its own bill_reference ("INV-0042 part 2"): parts with the same one replace each other. Give the source the bill came from. A second call with the same vendor and bill_reference (or, with no bill_reference, the same vendor and lines) replaces your earlier proposal; give the bill_reference every time if the bill has one.
propose_initiative_setup
ChatGPTDraft a new initiative's whole setup for a person to review and accept once in Roiva: the initiative from a library template (get_template shows what its formulas read), the date it went live where it was already running, its own assumption figures and baselines (each with a basis line naming the count, the rate, the document or system and who supplied it), the figures for each complete month since it went live, and a vendor bill's charges. Nothing in Roiva changes until a person accepts it there: they choose what to keep, recording the go-live approves the initiative and takes one of the plan's measured places, what the figures calculate waits for an approver, and the bill's lines wait to be booked. Say plainly that it is only a draft. Only figures the template's formulas read, and only ones an initiative can hold for itself; an account-wide figure is refused. For an initiative that already exists, use propose_past_readings, propose_plan_figures and propose_costs instead.
propose_past_readings
ChatGPTDraft the figures for the months an initiative has already been live, for a person to review and accept in Roiva: the months list_requested_readings lists as past months (the initiative's Past months page), for an initiative recorded as live from an earlier date. One call takes every figure and month for the initiative; the month Missing Inputs asks for (the last ended one) goes through propose_reading instead. Nothing in Roiva changes until a person accepts it there; each month whose figures are all in is then calculated (once the figures every month reads are set, which Roiva's reply names when they aren't), and what it calculates waits for an approver, so say plainly that it is only a draft. Give the source each figure came from. Roiva checks each month as the page would (it still takes a figure, isn't locked, the figure is in range) and says what to fix. A second call for the same initiative replaces your earlier proposal.
propose_plan_figures
ChatGPTDraft an initiative's business case: its planned figures, each with a basis line and the source it came from, for a person to review and save on Edit Business Case in Roiva. Nothing in Roiva changes until they save it there, so say plainly that it is only a draft. Open the help article writing-an-initiatives-business-case first. Write each basis line with the count, the rate, the document or system it came from, and who supplied it. Price hours at the loaded hourly rate the initiative's own formulas read (get_formula, get_assumptions), so the plan and the measured value are priced alike. Not while the initiative is in review (its CapEx and OpEx decide who approves it), nor once it was rejected or dismissed. After approval its budget doesn't move. Roiva says how each figure compares with the one there now. A second call for the same initiative replaces your earlier proposal, so give every figure you mean each time.
propose_reading
ChatGPTDraft one month's figure for a metric Roiva asks for (list_requested_readings), for a person to review and accept in Roiva. Nothing in Roiva changes until they accept it there, and what it calculates then waits for an approver; say so plainly to the user. Give the source the figure came from. Roiva checks it as the form would and says what to fix. A second call for the same initiative, metric and month replaces your earlier proposal. It takes only the month list_requested_readings asks for; earlier months since the initiative went live, the ones on its Past months page, go in one propose_past_readings call.
search
ChatGPTSearch the user's Roiva account for documents to read in full with fetch: initiatives, metric definitions, integration connections, initiative templates and help articles. Returns each one's ID for fetch, title and URL to cite. For the app's pages, people, vendors and assessments, use search_roiva.
search_roiva
ChatGPTSearch the user's Roiva account: initiatives, the app's pages, metric definitions (Roiva's library and the account's own), connections and the platforms not yet connected, vendors on cost entries, people, initiative templates, help articles, and active assessments. Use this to find IDs before calling other tools, or a page URL to send the user to.
withdraw_proposal
ChatGPTWithdraw one of your own proposals that is still waiting for a person. It changes nothing else.