Errors

Bad parameters, missing resources, or state conflicts. Synex Lab's PassQL tooling answers with 422 — see below.

Missing or invalid key, or the key's owner has left its team.

The key lacks the required ability — never granted, or no longer held by the member who minted it — or its ontology scope does not cover the resource; or the key's team is suspended or cannot issue passports.

Too many requests — honor the Retry-After header.

An idempotency key was reused with a different payload, or is still in flight.

Something failed on our side. Retry with backoff. Also Lab's 408 query_timeout.

A request field failed validation; param and errors say which.

The id doesn't exist in your team — resources in other teams read as missing. Also returned for unmatched routes.

The HTTP method is not supported on this endpoint.

The pagination cursor is malformed, tampered with, or replayed under a different set of filters. See pagination.

The merged metadata bag broke its limits — 50 keys, 40-character keys, 500-character values, string values only. param names the whole field or the offending entry.

The bag fits its own limits but would push the object it is stored on past the 400 KB storage ceiling. Send fewer or shorter keys.

Idempotency-Key exceeded 255 characters.

Typed idempotency_error. The idempotency key was already used with a different request payload.

Typed idempotency_error. The original request with this key is still running. Carries Retry-After; wait and retry.

Typed rate_limit_error. See rate limits.

Typed api_error. Something failed on our side; retry with backoff and the same Idempotency-Key.

No key was sent, the key is unknown, revoked or expired, or it is a credential the public API does not accept.

The key's owner is no longer a member of the team the key is pinned to.

The key does not hold the ability the endpoint requires — either it was never granted, or the member who minted the key no longer holds it. The message names the ability. See authentication.

The key's ontology scope doesn't cover this resource — including an ontology outside a scoped ontologies:read, a team-wide list under a scoped ability, and POST /v1/ontologies under a scoped ontologies:write. See ontology scopes.

The operation stands in for a passport write and the key holds no passports:write at all — opening or applying a data request or a bulk data request. param is passport, or selection on a bulk request. Refused before anything is looked up.

The key's team is suspended, so the key is refused whatever it was granted — on *:write endpoints at the write tier, on creating endpoints at the create tier, and on every authenticated endpoint at the full tier. See suspended teams.

The key's team has no company — it is a supplier team — so it cannot issue passports: POST /v1/ontologies, POST /v1/ontologies/:ontology/passports and POST /v1/imports refuse. Everything else the key was granted stays available.

abilities names something the calling key does not hold. See monotonic minting.

The requested ontology scope is wider than the caller's — including omitting it, or unscoping. param is scopes.

The key's own grants contradict each other: an ability held without the one it requires, or a scoped dependent reaching ontologies its ontologies:read does not. param is the dependent ability. Reported only once the subset checks pass. See ontologies are the root.

The team already holds its maximum of 32 live keys. Revoke one first; rolling is exempt.

The target key reaches further than the caller, so rolling it would hand over abilities. param is api_key.

A PATCH touching abilities or scopes on a key that reaches further than the caller. param is api_key.

Completed templates are immutable; only drafts can be edited or deleted.

Drafts can't be forked or instantiated — complete the template first.

The whole template — structure, names and descriptions — exceeds the 400 KB storage ceiling. Nothing was written.

No draft is open on this ontology.

A draft is already open. GET it, or DELETE it first.

base_updated_at is stale. Re-read the draft and reapply your changes.

expected_latest_version is stale. Re-read latest_version and retry.

The draft breaks the additive-change rules, or names a child level the structure doesn't define. One message per violation in error.errors.structure.

The ontology predates versioning and has not been backfilled, so its draft cannot be published. Contact support.

A passport property value was rejected; errors maps property id → failure details, each with its own code — see codes inside errors.

A range or file value nests objects and arrays past the storage ceiling.

The passport would exceed the 400 KB storage ceiling — values and change history. Nothing in the patch was written.

The level named — or the passport's own level — is not in the ontology's schema version. param names what was looked up.

A singular level already has a passport under that parent.

The friendly id is already used within the parent.

The passport is released: its values and friendly_id are frozen, it cannot be archived directly, and it cannot be deleted. Set publish_status to draft first. Also returned when applying a data request onto a released passport.

A passport cannot be released while an ancestor is not; the message names the nearest one. Release from the top down.

A released passport cannot be drafted while anything beneath it is still released. Draft the subtree first, deepest first.

A release run rooted at this passport or one of its ancestors is still running. Poll GET /v1/release_runs/:id until it is terminal, then retry.

The release moved under the request — cancelled, or released again — between the read and the write. Re-read the passport and decide again.

The release has already been reported for billing and can no longer be taken back. Contact support if it was reported in error.

A passport transfer is running on the passport's ontology, which freezes every write to its passports — values, friendly_id, publish_status, metadata, creating one beneath and deleting one. Nothing was written; retry once the transfer finishes.

No composition exists yet · a composition already exists.

The composition layout — or one language's strings — exceeds the 400 KB storage ceiling. Nothing was written.

lang is not one of the 24 official EU language codes. param is lang.

lang is the ontology's default language, whose strings are the composition document itself. param is lang.

One or more translation strings broke the contract — a malformed key, a non-string, or a string over its cap. param is strings, and error.errors is keyed by string key with one message each.

The address already holds a pending or linked supplier link with your team, or a resend was tried on a link that has been accepted. A revoked link releases the address.

A rename or resend on a revoked supplier link, or a data request opened against one. Invite the supplier afresh.

A draft or submit on a data request that is not open or changes_requested, or a cancel on one already terminal.

A review, apply or return on a data request that is not submitted.

An apply with no value accepted, or a return with no value rejected.

An id in a bulk data request's selection cannot be taken — not your passport, another level or ontology, an ambiguous friendly id, another pinned version. param is selection, and error.errors is keyed by the offending id. Nothing is opened.

The selection names more than 500 passports.

An answers upload on a bulk request whose children are not made yet — poll its creation job first.

A cancel, submit_all, apply_all, upload or fill on a bulk request that is already closed.

submit_all on a bulk request with no child left to answer.

apply_all on a bulk request with no submission waiting.

fulfil/match on a bulk request the customer marked no identifier on — pair the rows by hand with fulfil/fill.

The endpoint URL is not https, carries userinfo, is too long, or resolves into a blocked range.

An unknown event type, or "*" mixed with concrete types.

The team already holds 16 endpoints.

A concurrent upload took the filename; retry to get the next free name.

A folder of that name already exists in the directory.

The file exists but is not a spreadsheet the preview can parse — distinct from resource_missing.

complete listed fewer parts than the multipart upload was planned with; the message names the missing part numbers.

A second complete, or a DELETE after completing, on a multipart upload.

The team hasn't enabled Synex Lab.

The deployment's transform allowlist does not include this team.

A transform preview expired or no longer matches the submitted AST.

Only the latest finished, non-rolled-back transform can be rolled back; check each run's rollback_eligible.

Only query runs can be exported.

The export is still being written. Poll the run rather than retrying the download.

The AST failed validation — a malformed or unknown node. Also a request body that is not an AST object.

The AST is well-formed but could not be compiled to a query.

A property name resolves to conflicting types across the selected ontologies. Reference it by id; errors[].candidates lists the conflicting definitions.

A grouped query produced more groups than the cap. Group by a lower-cardinality property, or add filters.

The ast.cursor keyset token is malformed or stale — restart from the first page.

Typed api_error. The query exceeded the statement timeout — narrow the filter, reduce the page size, or use an export.

Typed permission_error. A source ontology is not accessible. An id that does not exist and one belonging to another team are deliberately indistinguishable.

dsl_text is blank on POST /v1/lab/dsl/parse.

The PassQL failed to parse. error.errors carries positioned rows — message, offset, length, expected.

A from clause named an ontology that does not exist in this team. offset and length are null.

An ontology name matched more than one ontology; errors[].expected lists the candidate ids. Address it by id.

dsl/print was handed an AST it cannot render back to PassQL.

The value is not of the property's type.

The value is not a numeric measurement, a range with a numeric start, or a file reference.

A date value or cell is not a calendar day — impossible, out of range, or relative. See passports.

A numeric date like 03/04/2026 reads both ways; send YYYY-MM-DD. See passports.

A number is outside the storable magnitude 1E-130–9.9999…E+125.

The value nests past the storage ceiling.

A translation is over its type's cap — 255 characters for short_text, 7,000 for long_text, 50 tags of at most 64 characters. Carries language.

The value is too large to store. On a passport PATCH this is reported as 413 passport_too_large instead.

A translated value is keyed by something other than one of the 24 official EU language codes, in lowercase.

The property carries no writable value — a category divider or a computed composite.