Reference
Errors and refusals
Why a row is refused
A refused row doesn’t stop the others. The rest of the batch is taken. Each refusal names the row (counting from 1 in an uploaded file or the connector’s page, from 0 in an API answer’s index), the field (the column) and a reason.
| Reason | When | What to do |
|---|---|---|
missing |
A required column, or a key column, has no value. For a text column an empty string counts as missing. | Send the value, or untick Required. |
too_long |
A text is over 500 characters. | Shorten it. |
bad_text |
A text column got something that isn’t text or a number, such as a list, or it holds a NUL character. | Send text. |
bad_number |
A number column got something that isn’t a number. | Send a number or a string that holds one. |
not_minor_units |
A money column got something that isn’t a whole number. 24.50, 2400.0 and "24.00" all count. |
Send whole cents: 2450. |
bad_bool |
A true/false column got something other than true or false. |
Send true or false. |
bad_time |
A time column got something that isn’t RFC 3339 with an offset, such as 2026-11-14T09:30:00+11:00. A date alone isn’t enough. |
Send a full time with an offset. |
bad_type |
The column’s type isn’t one Mestra knows. | Choose a type from the list. |
bad_currency |
In the Point of sale tables, currency isn’t three upper-case letters. |
Send AUD, not aud or Australian dollars. |
A blank cell is no value in every column except text. A value that doesn’t fit refuses the whole record, whether the column is required or not.
To fix refused rows, correct the data at its source or the column’s type. Then send it again, or replay what Mestra kept.
Messages you might see
Opening Topos
| Message | Meaning |
|---|---|
| “Mestra Topos isn’t on for” your organisation | Topos is a separate subscription. Get in touch through Support. If you belong to other organisations, you can switch to one that has it. |
| “Sign in to Mestra Topos” and “Topos opens from Mestra. Open it again to sign in.” | Your session ended. Select Open Mestra Topos. |
| “Decisions aren’t available right now. Try again shortly.” | Mestra can’t run decisions for a moment. Try again. |
Sending data (POST /ingest/…)
See the table in Send data to Mestra.
Saving a connector
A save lists every problem with a path. See the table in Routes, modes and columns. These also appear:
| Message or code | Meaning and what to do |
|---|---|
key_taken |
A connector with that key exists. Choose another key. |
The key new |
Reserved. Choose another key. |
| “Enter the header values again: the address changed.” | You changed the address of a fetch connector. Enter the header values again. |
| “Enter the value again. Saving new values replaces all the saved ones.” | Enter every header’s value when you change any. |
| “must be at least 60” or “Every must be at least 1 minute.” | A fetch connector can’t run more often than every minute. |
Running a fetch connector
| Code | Meaning |
|---|---|
not_pull |
The connector doesn’t fetch from an address. |
busy |
It is being fetched right now. Try again in a moment. |
pull_failed |
The address couldn’t be fetched. The reason names no header value and no text of the answer. See Fetch data on a schedule. |
fetch_failed (in a test) |
The address couldn’t be fetched. The short reason is “status 500”, “answer too large”, “address not allowed” or “couldn’t reach it”. |
unreadable |
The answer doesn’t read as JSON or CSV. It is kept all the same. |
routing_failed |
A route couldn’t write its table. Fix the connector, then replay. |
Tables and folders
| Message or code | Meaning and what to do |
|---|---|
“Empty the folder first.” (not_empty) |
A folder that holds a folder or a table can’t be deleted. |
name_taken |
The folder already has an item with that name, whatever the case. |
inside_itself |
A folder can’t be moved into itself or into a folder under it. |
in_use |
A table that a connector still fills can’t be deleted. The message names the connector. |
reserved |
The table belongs to a template. It can’t be deleted, and its key can’t be reused. |
| “That view took too long to read. Add a filter to narrow it, or sort by another column.” | A very large view. Narrow it with a filter. |
| “No rows match” | Nothing fits the filters. Select Clear filters. |
| “No rows yet” | A connector or upload hasn’t filled the table. |
Decisions
| Message or code | Meaning and what to do |
|---|---|
“Line N: …” (compile) |
The source can’t be read. Fix the marked line. |
| “define a function decide(ctx)” | The source has no decide function. |
“Approve the rules first” (rules_not_approved) |
The campaign’s rules aren’t approved, so it can’t be tested. |
“Save the table first” (no_table) |
The campaign has no table yet. |
“What this screen can see is too large for a decision to read.” (scope_too_large) |
The screen’s place has too many items for 256 KiB. Test with another screen, or read fewer items. |
“That version can’t be made live: it is already live, or it was taken down or replaced.” (cannot_go_live) |
Save a changed source as a new version. |
“That version isn’t the one screens follow, so there is nothing to take down.” (not_live) |
Only the live version can be taken down. |
“There’s no such version.” (unknown_version), “There’s no such decision.” (unknown_decision) |
The version or decision doesn’t exist. |
| “A decision stays with its campaign.” | A saved decision can’t move to another campaign. Make a new decision. |
“This table is too large to edit as a decision. It still runs as a table.” (too_large) |
Write the decision by hand. |
The reasons a decision falls back to the default are in Decisions.
A connector keeps failing
- Open it on Ingest and read the error under Health.
- Open Past runs to see when it began and how many rows were refused.
- For a fetch, select Run now to try again at once.
- If a payload was kept but a route failed, fix the connector and select Replay.
- If the error is about an address or a header, see Fetch data on a schedule.
If you are stuck, write to Support with the connector’s name and the exact message.