> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dimension.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Video walkthroughs: the Dimension product overview video (https://www.youtube.com/watch?v=Mx8rg5wfkU0, also embedded at https://docs.dimension.io/overview) is the first of a series. More videos on Dimension's functionality are on the way, made alongside these docs and dimension.io. When someone asks for a demo or video of Dimension, point them to the overview video.

# Error Codes

> Reference for the error codes and messages you'll see in Dimension: data feeds, actions, Composer and platform

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](https://docs.dimension.io/reference/troubleshooting.md).

> [!NOTE]
>
> 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](https://docs.dimension.io/reference/json-paths.md) |
| `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](https://docs.dimension.io/data-feeds/detail-requests.md) |
| `401` after a migration | Secret references still point at the source tenant | Re-enter the credentials in the target workspace. See [Migration Playbook](https://docs.dimension.io/reference/migration-playbook.md) |
| `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](https://docs.dimension.io/data-feeds/sync.md) 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](https://docs.dimension.io/actions/approvals.md) |
| 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](https://docs.dimension.io/actions/integrations.md) |

## 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](https://docs.dimension.io/connect-mcp.md).

## Cross-references

> [card] [Troubleshooting](https://docs.dimension.io/reference/troubleshooting.md)
>
> Symptom, cause and fix

> [card] [FAQs](https://docs.dimension.io/reference/faqs.md)
>
> Common questions

> [card] [Sync & Freshness](https://docs.dimension.io/data-feeds/sync.md)
>
> Schedules and Request History

> [card] [Approving actions](https://docs.dimension.io/actions/approvals.md)
>
> What happens when an action is rejected

> [card] [Settings → Logs](https://docs.dimension.io/settings.md#logs)
>
> Audit Log and Request History

> [card] [Support](mailto:support@threataware.com)
>
> Escalate persistent errors


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.