mastra-ai/mastra
Documented errors, page 22 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| ClaudeSDKAgent resumeData.continue must be true when… | validation | error | http-404, not-found, versions, rest-api |
| Failed to create access token | exception | error | network, api, authentication, http |
OBSERVABILITY_STORAGE_GET_ROOT_SPAN_NOT_IMPLEMENTED This storage provider does not support getting root spans | error_code | error | storage, observability, tracing, unsupported-operation |
| Model " " is not available. Available models | validation | error | http-404, not-found, versions, rest-api |
| No model generation span found in trace | exception | error | trace, llm-span, scoring |
| Step is required and must be a valid step or array of steps | exception | error | workflow, resume, validation, missing-parameter |
| Could not parse | exception | error | json, manifest, parse-error, config |
| Factory rules.github must be an object. | validation | error | validation, structure, github, factory-rules |
| Malformed referencePath | http | error | http-400, url-encoding, validation, skills |
| Factory project not found for this organization. | exception | error | source-control, not-found, factory-project, connection |
| Invalid Subconscious record time | validation | warning | llm, validation, date-parsing, subconscious |
| Path traversal detected: file | exception | error | security, path-traversal, filesystem |
| writeMjpegAviFile: dimensions exceed AVI header bounds | validation | error | avi, dimensions, limits, header |
| No root agent_run span found in trace | exception | error | trace, agent-run, span-type |
| ClaudeSDKAgent resumeData.sessionId must be a string. | validation | error | http-404, not-found, versions, rest-api |
| Extractor name is required. | validation | error | observational-memory, extractor, naming, input-validation |
| Failed to read step " " in lesson | exception | error | filesystem, io, read-error |
| IDs array length must match vectors array length | error_code | error | validation, vector-store, upsert, ids |
| Invalid metadata filter value for key | validation | error | validation, storage, metadata |
| Turn not started — call start() first | exception | error | observational-memory, lifecycle, state |
| You do not have permission to update this connection | http | warning | http-403, authorization, tool-providers, permissions |
EXPERIMENT_ALREADY_FINALIZED Experiment is already ; no further items can be run | error_code | error | storage, experiments, state-machine, user-error |
| AgentScheduleWorker: call init() before start() | exception | error | worker, initialization, lifecycle |
| metadata.avatarUrl is empty | http | error | http-400, empty-value, metadata, validation |
| metadata.avatarUrl must be a valid data URL | http | error | http-400, format-validation, metadata, data-url |
| runId required to start run | http | error | http-400, validation, missing-parameter, workflow-run |
| Server cache not found | http | error | http-500, server-cache, configuration, mastra-server |
| Factory rules.tools must be an object. | validation | error | validation, structure, tools, factory-rules |
| No model selected. Use /models to select a model first. | exception | error | configuration, ux, model-selection |
| ${response.error} | exception | error | api-response, network, auth |
| Harness pending item | exception | error | storage, harness, duplicate-id, pending-items |
| HTTP URL is required | exception | error | logging, configuration, http, validation |
| Invalid request index. indexName and vectors array are… | http | error | http-400, request-body, vector, validation |
NO_SANDBOX Workspace does not have a sandbox configured | error_code | error | configuration, workspace, sandbox, missing-config |
OBSERVABILITY_STORAGE_LIST_FEEDBACK_NOT_IMPLEMENTED This storage provider does not support listing feedback | error_code | error | storage, observability, not-implemented, feedback |
| page must be 0 when perPage is false | validation | error | validation, pagination, storage |
| Parallel API key is required. Pass | validation | error | api-key, configuration, environment, parallel |
| Failed to remove GitHub token | http | error | http, github, auth, fetch |
| Thread not found | exception | error | memory, thread, working-memory, not-found |
| Previous object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Trace must have a spans array | exception | error | trace, shape-validation, scoring |
| Subconscious requires threadId to derive scoped knowledge. | exception | error | configuration, subconscious, thread, request-context |
| Cannot set both `model` and `reflection.model`. Use `model`… | validation | error | config, validation, conflicting-options |
| Cancelled | exception | warning | cli, interactive, user-cancellation, prompt |
| Experiment result not found | exception | error | storage, experiments, inmemory, missing-resource |
| Invalid arguments for firecrawl_crawl | exception | error | mcp, validation, type-guard |
| Failed to stream agent builder action | http | error | network, http, streaming |
| Repository not found in organization | exception | error | source-control, not-found, migration, in-memory |
| App manifest update failed | exception | error | slack, manifest, config-drift, validation |
| Worker arguments must not contain NUL bytes. | validation | error | worker, validation, argv |
| Responses requests require an agent_id | http | error | server, validation, http-400, responses-api |
| ACP connection is not initialized | exception | error | http-404, not-found, versions, rest-api |
EXPERIMENT_INVALID_TARGET targetType and targetId must be provided together | error_code | error | storage, experiment, validation, invalid-arguments |
| A work item cannot relate to itself. | exception | error | storage, work-items, validation |
| CursorSDKAgent resumeData.agentId must be a string when… | validation | error | resume, validation, type-error, cursor |
| Model config with id | http | error | http-404, agents, model-list, not-found, stale-identifier |
| Prompt block with id | http | error | http-404, storage, not-found |
| topK must be a positive integer | error_code | error | validation, vector-store, query, topk |
| Failed to stream vNext workflow | http | error | network, streaming, workflow |
| runId required to observe workflow stream | http | warning | http-400, validation, mastra-server |
| notification-inbox requires id | exception | error | notifications, tool, missing-argument |
SCHEDULES_NOT_FOUND Schedule " " not found. | error_code | error | schedules, not-found |
| Vector name is required | http | error | http-400, missing-parameter, vector, api |
| . . must be an object. | validation | error | validation, structure, handlers, factory-rules |
| Snapshot not found for run | exception | error | workflow, restart, storage, snapshot, crash-recovery |
| Skill with id not found | exception | error | storage, not-found, skills, in-memory |
| Failed to list projects | exception | error | network, api, authentication, http |
| Cannot merge a knowledge node into itself | exception | error | knowledge-store, merge, invalid-argument, self-reference |
| Vector store not found | http | error | http-404, not-found, vector, configuration |
| Tool ID is required | http | error | http-400, validation, tools, api |
| MCP server with id not found | exception | error | storage, not-found, mcp-server, in-memory |
| Next object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Messages are required | http | error | http-400, validation, request-body |
| Subconscious capture requires an active Memory instance. | exception | error | configuration, memory, subconscious, storage |
| ClaudeSDKAgent resumeData must include either sessionId or… | validation | error | http-404, not-found, agents, rest-api |
| Invalid arguments for firecrawl_map | exception | error | mcp, validation, type-guard |
| Parent object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Tavily API key is required. Pass | validation | error | api-key, configuration, environment, tavily |
| Trace has no spans | exception | error | trace, empty-data, scoring |
| Failed to create project | exception | error | network, api, http, project-creation |
| App deletion failed | exception | error | slack, api, lifecycle |