📄 ai-sdk/docs/reference/ai-sdk-rsc/get-mutable-ai-state
File: get-mutable-ai-state.md | Updated: 11/15/2025
Source: https://ai-sdk.dev/docs/reference/ai-sdk-rsc/get-mutable-ai-state
Menu
v5 (Latest)
AI SDK 5.x
Model Context Protocol (MCP) Tools
Copy markdown
===========================================================================================================
AI SDK RSC is currently experimental. We recommend using AI SDK UI for production. For guidance on migrating from RSC to UI, see our migration guide .
Get a mutable copy of the AI state. You can use this to update the state in the server.
import { getMutableAIState } from "@ai-sdk/rsc"
Parameters
key?:
string
Returns the value of the specified key in the AI state, if it's an object.
Returns
The mutable AI state.
Methods
update:
(newState: any) => void
Updates the AI state with the new state.
done:
(newState: any) => void
Updates the AI state with the new state, marks it as finalized and closes the stream.
Learn to persist and restore states AI and UI states in Next.js
On this page
Deploy and Scale AI Apps with Vercel.
Vercel delivers the infrastructure and developer experience you need to ship reliable AI-powered applications at scale.
Trusted by industry leaders:
- OpenAI
- Photoroom
