Error Codes

This page lists the error codes and named messages you’ll meet in Dimension, and where each one shows up. For symptom-by-symptom fixes, see Troubleshooting.

Dimension doesn’t have a public API yet, so there are no Dimension API status codes to list. The HTTP codes below come from the outside services your data feeds and actions call. Their exact messages vary by service.

Data feed request errors

When you click Test in the Data Feed editor, an error appears inline. Every run is also listed with its HTTP status code and error message in ⋯ → Advanced → Request History, and across the tenant in Settings → Logs → Request History.

HTTP status	Usual cause	Fix
`200` with 0 records ingested	The Data Path doesn’t point at the array of records	Check the response in the Test panel and correct the Data Path. See JSON Path Reference
`401` / `403`	Credentials are wrong, expired or lack access	Re-enter the value in the Variables panel, click the lock icon to encrypt it, then Test again
`401` on a Detail Request when the Data Request returns `200`	The Detail Request isn’t reusing the primary credentials	Set the Detail Request’s Authorization to Inherit from parent. See Detail Requests
`401` after a migration	Secret references still point at the source tenant	Re-enter the credentials in the target workspace. See Migration Playbook
`404`	Wrong URL or API version, or the resource isn’t visible to your credentials	Check the path (for example `/v1` against `/v2`) and the tenant ID in the URL
`429`	The source is rate-limiting Dimension	Reduce the sync cadence, or ask the Composer to add a delay between requests
`5xx`	The source service is down or erroring	Check the source’s status page, then refresh the feed once it recovers
Timeout	The source took too long to respond	Add pagination or reduce the page size

Data feed messages

Message	Where it appears	Meaning
Please publish this data feed in order to trigger a run.	Hovering the refresh icon in the Data Feed editor	The feed is a draft. Only published feeds run on a schedule or from the refresh icon. Test still works on a draft
Data preview icon disabled	Data Feed editor toolbar	The feed hasn’t had a successful run yet

See Sync & Freshness for schedules and Request History.

Action errors

Error	Where it appears	Fix
Webhook returns a non-2xx status	Settings → Logs → Request History, with the response code	Usually a wrong URL, expired auth or malformed JSON in the body. Reproduce it with sample inputs in the Action editor’s Test panel
Rejected action	The app shows whatever it does on failure, for example Failed, try again	Someone chose Reject in the Approve Actions panel, so the action didn’t run. See Approving actions
Email Action sends nothing	No delivery	Recipients must be users in your tenant. To email outside addresses, call an email API from a Webhook Action instead. See Action integrations

Composer and Studio messages

Message	Where it appears	Meaning
Did you forget to add a data feed?	Confirm dialog when you send a first prompt to a new app with no data feeds	Click Proceed with no data feeds for an app without data, or Cancel to add a feed first
The Composer says it can’t find a field	Composer chat	The field isn’t in the feed’s schema, or it’s been renamed. Check ⋯ → Advanced → Schema and use the real field name
Blank preview after a prompt	Studio preview	The generated code throws when it renders. Ask the Composer to fix the error, or use Restore checkpoint
Publish disabled	Studio editor	The draft matches what’s published, or the Composer is still generating
Share URL greyed out	Editor ⋯ menu	The app hasn’t been published yet

Platform messages

Message	Where it appears	Meaning
Sorry, a resource cannot be found	Any page (404)	The link is out of date: the item was deleted or migrated. Go back to the workspace overview and find it there
No workspaces in the switcher	Workspace switcher	You don’t have access to any workspace yet. Ask a Super Admin, or create your own

Connecting an AI assistant (MCP)

Symptom	Fix
The server doesn’t connect	Check you used your own tenant’s URL, and that your organisation allows custom MCP servers in your assistant
Sign-in fails or loops	Check you can sign in to Dimension in your browser with the same account, then remove the server and add it again
The assistant can’t find a workspace	The server only sees workspaces your account can access

See Connect with MCP.

Cross-references

Troubleshooting

Symptom, cause and fix

FAQs

Common questions

Sync & Freshness

Schedules and Request History

Approving actions

What happens when an action is rejected

Settings → Logs

Audit Log and Request History

Support

Escalate persistent errors

Get started

Core Concepts

Build

Reference

Settings

Trust & Security

Data feed request errors

Data feed messages

Action errors

Composer and Studio messages

Platform messages

Connecting an AI assistant (MCP)

Cross-references

Troubleshooting

FAQs

Sync & Freshness

Approving actions

Settings → Logs

Support