---
product: "AG Studio"
title: "Studio API Reference"
description: "To access the API, see ."
framework: angular
version: "3.0.0"
related:
    - title: "Overview"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-interface/"
    - title: "Properties Reference"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-properties/"
    - title: "Events Reference"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-events/"
    - title: "Theme Reference"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-theme/"
    - title: "State Reference"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-state/"
    - title: "Studio Lifecycle"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-lifecycle/"
    - title: "Registry Type"
      url: "https://www.ag-grid.com/studio/archive/3.0.0/angular/registry-type/"
llms: "https://www.ag-grid.com/studio/archive/3.0.0/llms.txt"
---

# Studio API Reference

To access the API, see [Studio API](https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-interface/#studio-api).

## AI

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `getAiContext` | `Function` |  | Returns a plain typed namespace exposing AI-relevant information about this Studio instance. Synchronous surfaces (`schema`, `catalogue`, `vocabulary`, `fragments`) are cheap reads — `schema` and `catalogue` re-evaluate current state on every call. Async surfaces (`health`) perform data-engine round-trips. See [Agent Context](https://www.ag-grid.com/studio/archive/3.0.0/angular/ai-context/). |
| `getAiTools` | `Function` |  | Returns the built Studio AI tools, bound to this Studio instance and ready for an agent to run. They read live dashboard state at execute time, so pull the toolkit once and close over it when declaring an agent's tools (e.g. inside `ai: ({ api }) => createAiHarness(api, ...)`). See [Tools Overview](https://www.ag-grid.com/studio/archive/3.0.0/angular/ai-tools/). |
| `defineAiTool` | `Function` |  | Build a tool an agent can list, bound to this Studio instance. Pass one of: - `{ name, description, command, result }` - a tool whose action is an AgAiCommand. The command's own input shape is the tool's schema; `result` turns what the command returned into the response the LLM sees. - `{ name, description, params, execute }` - a tool that runs its own `execute`, for anything that is not a single command. Build the result with `ctx.success` / `ctx.error`. - `{ kind: 'server', name, description, params }` - declared here, executed by the agent's own harness. Studio advertises the schema and never runs it. - `{ kind: 'provided', name, description, provider }` - hosted and run by the LLM provider; `provider` is passed through to the adapter untouched. The returned tool reads live state when it executes, so build it once and list it from an agent's `tools` callback. See [Custom Tools](https://www.ag-grid.com/studio/archive/3.0.0/angular/ai-custom-tools/). |
| `defineAiCommand` | `Function` |  | Resolve an AI command bound to this Studio instance. The argument is either: - a factory callback `(builder, lenses) => { input, execute }` for a custom command; the returned `AgAiCommand` exposes `toJSONSchema()`, `parse()`, and `apply()`. - a built-in command reference `{ type: 'AgX', params? }` to retrieve one of the commands shipped with Studio. The built-in ships the schema + execute; the consuming AI library adds the name, description, status text, and UI. Name, description, status text, and UI belong to the consuming AI library in both cases. See [Commands](https://www.ag-grid.com/studio/archive/3.0.0/angular/ai-tools/#commands-the-layer-below). |

## Data

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `reload` | `Function` |  | Reload all data from the data sources. See [Reloading Data](https://www.ag-grid.com/studio/archive/3.0.0/angular/loading-data/#reloading-async-data). |

## Lifecycle

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `destroy` | `Function` |  | Will destroy the Studio instance and release resources. If you are using a framework you do not need to call this, as Studio links in with the framework lifecycle. However if you are using native JavaScript, you need to call this to avoid a memory leak in your application. |
| `getStudioId` | `Function` |  | Returns the `studioId` for the current Studio instance as specified via the Studio property `studioId` or the auto assigned Studio ID if none was provided. |

## Properties

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `getProperty` | `Function` |  | Returns the Studio properties value for a provided key. See [Studio Properties](https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-properties/). |
| `setProperty` | `Function` |  | Updates a single Studio property to the new value provided. (Cannot be used on `Initial` properties.) If updating multiple options, it is recommended to instead use `api.updateProperties()` which batches update logic. See [Studio Properties](https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-properties/). |
| `updateProperties` | `Function` |  | Updates the provided subset of Studio properties with the provided values. (Cannot be used on `Initial` properties.) See [Studio Properties](https://www.ag-grid.com/studio/archive/3.0.0/angular/studio-properties/). |

## State

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `getState` | `Function` |  | Get the current state of Studio. Can be used in conjunction with the `initialState` Studio property or `api.setState()` to save and restore Studio state. See [Saving and Restoring State](https://www.ag-grid.com/studio/archive/3.0.0/angular/state/). |
| `setState` | `Function` |  | Set the current state of Studio. Can be used in conjunction with `api.getState()` or `onStateUpdated` to save and restore Studio state. The state is expected to be a full state object, not a partial state object. State must be updated immutably as Studio uses reference equality to determine which parts of state have changed. See [Saving and Restoring State](https://www.ag-grid.com/studio/archive/3.0.0/angular/state/). |
| `undo` | `Function` |  | Undo the last change to the durable document state (widgets, layout, filters, schema). View state such as the selected page or selection is left as it is, then brought back into view for the restored change. No-op when there is nothing to undo (`getHistory().undo` is empty). Pass a `getHistory().undo` entry's `id` to undo every change back through that entry in a single step; an unknown id is a no-op. See [Undo & Redo](https://www.ag-grid.com/studio/archive/3.0.0/angular/undo-redo/). |
| `redo` | `Function` |  | Redo the change most recently undone. No-op when there is nothing to redo (`getHistory().redo` is empty). Making a fresh change discards the redo branch. Pass a `getHistory().redo` entry's `id` to redo every change forward through that entry in a single step; an unknown id is a no-op. See [Undo & Redo](https://www.ag-grid.com/studio/archive/3.0.0/angular/undo-redo/). |
| `getHistory` | `Function` |  | The editing history: the live state plus what `undo()` and `redo()` would step through, each entry labelled and timestamped. Drives control enablement (an empty `undo` stack means there is nothing to undo) and a history list. History does not survive loading new state. See [Undo & Redo](https://www.ag-grid.com/studio/archive/3.0.0/angular/undo-redo/). |
| `clearHistory` | `Function` |  | Discard the undo and redo history, so `getHistory()` returns empty stacks and `undo()`/`redo()` become no-ops until the next change. The live state is untouched. See [Undo & Redo](https://www.ag-grid.com/studio/archive/3.0.0/angular/undo-redo/). |

## Widgets

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `performWidgetAction` | `Function` |  | Execute an action for a widget. Action can be one of the default actions (`'duplicate'` or `'delete'`), or an action specific to that widget. See [Widget Toolbar Actions](https://www.ag-grid.com/studio/archive/3.0.0/angular/widget-configuration/#toolbar-actions). |