mastra-ai/mastra
Documented errors, page 21 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Subconscious requires resourceId to derive scoped knowledge. | exception | error | configuration, request-context, subconscious, resourceid |
| Target type ' ' not yet supported. | exception | error | configuration, experiment, unsupported-feature |
| Template " " not found | exception | error | cli, template, not-found, argument |
| : version number already exists for entity | exception | error | storage, versioning, conflict |
| Thread with id not found | exception | error | storage, not-found, in-memory |
| Tool must have input and output schemas defined | exception | error | tool, schema, validation, workflow |
VECTOR_INVALID_ID Vector id must be provided and cannot be empty | error_code | error | configuration, vector-store, constructor |
| Factory rules.tools. | validation | error | validation, structure, tools, handlers |
| MCPClientServerProxy does not support Hono SSE transport | exception | error | mcp, unsupported-transport, hono, sse, client-proxy |
| runId is required to stream an agent builder action | validation | error | client, validation, streaming |
| StdioCodeModeTransport requires a sandbox | exception | error | code-mode, sandbox, transport, configuration |
| This relationship would create a cycle. | exception | error | storage, work-items, cycle, hierarchy |
| writeMjpegAviFile: invalid dimensions | validation | error | avi, dimensions, input-validation |
| Invalid arguments for firecrawl_scrape | exception | error | mcp, validation, type-guard |
| No threadId found | http | error | http-400, validation, thread |
| Session expired | http | error | http-401, session-expired, authentication |
| Skipped: Scorer already exists at | exception | error | filesystem, duplicate, cli, conflict |
| Storage is not configured on this AgentController | exception | error | configuration, storage, memory |
| GitHub pull requests require an owner/repository source. | validation | error | github, validation, input |
| Keyboard event injection not supported by this provider | exception | error | input, unsupported-operation, provider-capability |
| Phase is required | validation | info | mastra-server, validation, http-400, bad-request |
| Processor does not support outputResult phase | validation | error | http-400, processors, phase-not-supported |
| sendStateSignal requires Mastra memory | exception | error | agent, memory, configuration, signal |
| toAISdkFormat() has been deprecated. Please use… | exception | error | deprecation, breaking-change, client-sdk, migration |
| TopK must be greater than 0 | validation | error | rag, invalid-argument, query, validation |
| Unknown Subconscious reflection agent | exception | error | configuration, validation, observational-memory |
| VoyageAI API key is required. Set VOYAGE_API_KEY… | validation | error | api-key, configuration, env-var, voyageai |
| xAI token refresh failed | exception | error | oauth, xai, token-refresh, http |
| Need MOONSHOT_API_KEY | exception | error | configuration, env-var, api-key, authentication |
| resourceId is required for observational memory lookup | http | error | validation, observational-memory, missing-parameter |
| ScoresStorage not configured. | exception | error | storage, configuration, experiments, analytics, scores |
| Span not found | http | warning | http-404, observability, tracing, spans |
| Tool provider does not support authorize | http | error | http-400, tool-providers, missing-capability, oauth |
| Worker command must be a non-empty executable path. | validation | error | worker, validation, configuration |
AGENT_STREAM_V2_MODEL_NOT_SUPPORTED Models with specificationVersion | error_code | error | agent, streaming, model-spec, deprecated-api, migration |
NO_WORKSPACE Workspace not available. Ensure the agent has a workspace configured. | error_code | error | configuration, workspace, missing-config, tools |
| Only `TextNode` is allowed for `Summary` extractor | validation | error | type-error, rag, node-types |
| Storage does not have a memory domain configured | exception | error | configuration, storage, memory |
| This endpoint is deprecated. Please use /stream instead. | http | warning | http-410, deprecated-endpoint, migration |
| Thread ID is required for recall | exception | error | validation, memory, thread-id |
| Token rotation failed | exception | error | oauth, slack, token-rotation, api |
| Blob storage domain is not available | http | error | storage, blobs, adapter |
| Cannot update merged knowledge node | exception | error | knowledge-store, merged-node, tombstone, update |
| Failed to time travel workflow | http | error | network, streaming, workflow |
| Harness pending item | exception | error | storage, harness, pending-item-not-found |
| Okta client ID is required. Provide it in the options or… | validation | error | okta, configuration, env-var, constructor |
| Sandbox provider " " does not support stop. | exception | error | sandbox, unsupported-operation, provider-capability, lifecycle |
| Vector at index is null or undefined | error_code | error | validation, vector-store, upsert, null-check |
| For custom model, modelName is required in… | exception | error | validation, configuration, fastembed |
| MCPClientServerProxy does not support SSE transport | exception | error | mcp, unsupported-transport, sse, client-proxy |
| Processor ID is required | validation | info | mastra-server, validation, http-400, bad-request |
| Scorer definition with id | exception | error | storage, not-found, scorer-definitions, in-memory |
| Storage not configured. Configure storage in Mastra… | exception | error | storage, configuration, experiments, analytics |
| Failed to create observe stream | http | error | http-500, streaming, version-mismatch |
| @mastra/livekit: set `agent` or `workflow`, not both — they… | validation | error | configuration, validation, livekit, worker |
| resourceId is required | http | error | validation, missing-parameter, observational-memory |
| UnixSocketPubSub does not support grouped subscriptions yet | exception | error | pubsub, unix-socket, unsupported-feature |
| Unknown OAuth provider | exception | error | oauth, configuration, provider-registry |
| App creation returned incomplete data | validation | error | slack, api-contract, response-shape |
| CursorSDKAgent resumeData must include a message. | validation | error | resume, validation, argument-validation, cursor |
| requires a request-context key — use . | validation | error | workflow, template, request-context, syntax |
| MCP server with id already exists | exception | error | storage, duplicate-id, mcp-server, in-memory |
| Okta client secret is required for SSO. Provide it in the… | validation | error | okta, configuration, env-var, sso |
| SandboxNotReadyError: sandbox with id | exception | error | sandbox, lifecycle, stale-reference |
| Path traversal detected: skill name | exception | error | security, path-traversal, skills, filesystem |
| Configured domain path | exception | error | filesystem, storage, configuration |
| Source-control installation not found | exception | error | source-control, not-found, installation, in-memory |
| Cursor run ended with status | exception | error | cursor, agent-sdk, runtime-failure, generate |
| Failed to attach Neon database | http | error | http-error, platform-api, neon, network |
| For custom model, modelAbsoluteDirPath is required in… | exception | error | validation, configuration, fastembed |
| No session | http | error | http-401, session, authentication |
| Vector contains invalid value (null, undefined, NaN, or… | error_code | error | validation, vector-store, upsert, numeric |
| Version number already exists for workspace | exception | error | storage, workspace, duplicate-key, versioning |
| Workspace not found | http | error | http-404, not-found, workspace, invalid-id |
| Course state update failed with status | exception | error | network, http, api |
| Cannot restart task in status | exception | error | background-tasks, state-machine, invalid-state |
| . . handlers must be functions. | validation | error | validation, handlers, type-mismatch, factory-rules |
| Metadata array length must match vectors array length | error_code | error | validation, vector-store, upsert, metadata |
| metadata.avatarUrl exceeds | http | error | http-413, payload-too-large, metadata, validation |
OBSERVABILITY_STORAGE_CREATE_FEEDBACK_NOT_IMPLEMENTED This storage provider does not support creating feedback | error_code | error | storage, observability, not-implemented, feedback |
| Root agent span has no output | exception | error | trace, missing-output, scoring |
| Version number already exists for MCP client | exception | error | storage, duplicate, versioning, mcp-client, in-memory |
| No workflow with id " ". | exception | error | workflows, not-found, storage |
| Observational Memory is not enabled for this agent | http | error | memory, observational-memory, http-400, configuration |
| Workspace filesystem not available | http | error | http-400, workspace, filesystem, configuration |
| Workspace is read-only | http | error | http-403, forbidden, read-only, workspace, permissions |
| Experiment result does not belong to experiment | exception | error | storage, experiments, inmemory, ownership-mismatch |
OBSERVABILITY_TRACE_ID_REQUIRED Trace ID is required for creating a span | error_code | error | storage, observability, tracing, missing-id, trace-context |
| runId required to resume workflow | http | error | http-400, validation, missing-parameter, workflow-run |
| Workflow " " not found | http | error | http-404, schedules, workflow, configuration |
| writeMjpegAviFile: at least one frame is required | validation | error | avi, muxing, input-validation, recording |
| Language is not supported! Please choose from | validation | error | configuration, unsupported-language, rag |
| Cannot save course state: User is not registered | exception | error | auth, registration, precondition |
| Memory error: Resource-scoped working memory is enabled but… | exception | error | memory, working-memory, validation |
SCHEDULES_ID_EXISTS schedules.create: a schedule with id | error_code | error | schedules, conflict, duplicate-id |
| A multi-line review comment requires both startLine and… | validation | error | github, validation, input |
| ACP prompt stopped before completing | exception | error | storage, configuration, server, http-500 |
| Invalid arguments for firecrawl_check_crawl_status | exception | error | mcp, validation, type-guard |
| notification-inbox search requires query | exception | error | notifications, tool, validation |
| Time travel target step not found in execution graph | exception | error | workflows, time-travel, execution-graph, invalid-path |