📄 ai-sdk/docs/reference/ai-sdk-errors/ai-invalid-message-role-error
File: ai-invalid-message-role-error.md | Updated: 11/15/2025
Source: https://ai-sdk.dev/docs/reference/ai-sdk-errors/ai-invalid-message-role-error
Menu
v5 (Latest)
AI SDK 5.x
Model Context Protocol (MCP) Tools
AI_TooManyEmbeddingValuesForCallError
AI_UnsupportedFunctionalityError
Copy markdown
========================================================================================================================================
This error occurs when an invalid message role is provided.
role: The invalid role valuemessage: The error message
You can check if an error is an instance of AI_InvalidMessageRoleError using:
import { InvalidMessageRoleError } from 'ai';
if (InvalidMessageRoleError.isInstance(error)) { // Handle the error}
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
