Help › Guide

Error codes

Reqlyn 0.5.1 is not released yet. This help describes it ahead of release.

Every failure has a stable code beside its sentence. The sentence says what happened and what to check; the code is what scripts, JUnit reports, run records and the server's answers carry. Codes are the same on this computer, on a server and on a private agent.

A run's input

Code Means
INPUT_SHAPE The operation is called with a JSON object of its inputs, and was given something else.
INPUT_NOT_JSON The input given on the command line is not JSON.
INPUT_UNKNOWN An input the operation does not declare.
INPUT_MISSING A required input was not given.
INPUT_KIND An input of another kind than declared; nothing is converted for you ("4831" is not an integer).
INPUT_TEXT Text that is too long or holds control characters: a string input past 2,048 characters or with a line break, a text input past 1 MiB or with a control other than a line break or tab.
INPUT_TEXT_PLACE A text input (long text) written into an address, a header, or a text or XML body: it goes only inside a JSON body.
INPUT_BRACES An input with braces that would be written into a header or a text body, where it could be read as a {{placeholder}}. A body that is XML (its Content-Type application/xml, text/xml or …+xml) escapes an input instead, braces and <, >, & and quotes among them, so it stays text.

A step

Code Means
STEP_STATUS The API answered a status that is not success, or not the one the step requires.
STEP_REPORTED The API answered success, and the step's error rule says the response reports a failure; the API's own message follows.
STEP_CRITERIA The response, or a message, does not meet the step's criteria.
STEP_MAPPING A placeholder is filled from a place in an earlier response that holds an object, a list or nothing: only text, a number or a boolean can be carried.
STEP_NOT_JSON The response is not JSON, and the step reads it. A success with no body at all, such as 204 No Content, gives nothing and is not refused.
STEP_XML The step reads XML, and the response is not XML it can read (a document type or entity is refused).
STEP_TRUNCATED The response was too large to keep whole, so nothing can be taken from it.
STEP_TIMEOUT No response in the time the step waits. The request was stopped; whether the API acted on it cannot be known.
STEP_NOT_SENT The request could not be sent as it is (an unknown variable, a secret variable in a document run from a file, …). Nothing was sent.
CREDENTIAL_NEW_ORIGIN The step's credential has not been allowed to go to the step's origin on this computer. Nothing was sent. Allow it with "Allow and send" from the request, in Connections, or with reqlyn credential allow <name> <origin>, then run again.
STEP_REQUEST_GONE The saved request a step sends no longer exists.
STEP_JOIN, STEP_CONDITION, STEP_EACH, STEP_PAGES A join, a condition, a loop or pagination could not do what it says, with why: no item matched, a list is not a list, a next link to another origin, …
STEP_NOT_REACHED A step that waits for a value was asked as often as it may be, and never showed it.
STEP_WAITS_ON_WRITE A step that waits for a value sends a request that writes, so it is not asked again.
STEP_NO_CALLBACKS A step waits for a callback, and only a server whose operator set REQLYN_CALLBACK_URL gives addresses. Nothing was sent.
STEP_NOT_CALLED_BACK Its request was sent, and no callback came in time.
STEP_NO_SCRIPTS A step has a script, and it was run by something that runs no scripts, such as a private agent older than scripts. Nothing was sent.
SCRIPT_ASSERTION A step's script asserted something (rq.assert) that does not hold; its line and its message follow.
SCRIPT_ERROR A step's script threw an error; its line and the error follow.
SCRIPT_LIMIT A step's script ran longer than 50 ms, or needed more than 16 MiB of memory, and was stopped.
SCRIPT_REFUSED A step's script reached for the network or a file (fetch, require and the like). A script cannot.
SCRIPT_CHANGE A before script changed what a script may not: where the request goes (its scheme, host or port), the method, a form's body, or a {{placeholder}} it put where the request did not hold it. Nothing was sent.
SCRIPT_UNSET A request holds {{name}} for a name a step's script says it sets, and no script had set it yet. It is not filled from a variable of that name. Nothing was sent.
SCRIPT_VALUE An after script set a value its step does not declare, or one that is not text, a number or a boolean within an input's limits.
SCRIPT_UNAVAILABLE The script could not be run at all, with the reason: its sandbox could not be started.
STEP_NO_MESSAGES A step sends or receives a message where messages are not carried.
STEP_NOT_HEARD No message came within the step's timeout.
STEP_MESSAGE A message could not go or be heard, with why.
STEP_NO_UNDO An undo was asked of a step that names no undoing request.
STEP_FAILED A step failed for a reason that has no code of its own (in a JUnit report).

The output

Code Means
OUTPUT_MISSING The response has nothing at the place an output field is taken from. A field that may be null is null when the response leaves it out of an object that is there; a path that leads nowhere is still missing.
EVALUATION_FAILED A step's evaluation did not hold: the text at its place is not like the expected answer by enough of its words, or the configured model judged it does not meet the rubric. The run's output is kept; the message says which evaluation and why.
OUTPUT_NULL A field is null, and the contract does not allow it.
OUTPUT_KIND A field holds another kind than the contract says.
OUTPUT_NOT_A_LIST A list field, and the step's result is not a list.

The run as a whole

Code Means
RUN_LIMIT The run reached its limit of requests or time and was stopped, whatever its steps say about going on.
RUN_CANCELLED The run was cancelled. What it had done is not undone; a request under way is uncertain.
RUN_INTERRUPTED The server that ran it stopped, or lost the queue, while it was under way. It is never sent again.
RUN_STOPPED The run stopped unexpectedly before it finished.
RUN_NOT_STARTED The run could not begin: its version, environment or input could not be made ready.
RUN_NOT_ACCEPTED, RUN_FAILED In a load test: the server did not take one of its runs, or a run failed without a code of its own.
EXAMPLE A replay ran out of kept responses: the example or case was kept from the operation as it was then.
CASE_NOT_RUN A regression case gave no output when replayed: a step's request is not the version's, the case kept no response for it, or a step's criteria do not hold of what it kept.
OPERATION_DEFINITION The operation, or its Arazzo source, is not one Reqlyn can run, with each problem at its place.
OPERATION_NOT_FOUND No stored operation by that name or id, or several by that name.
OPERATION_CONFLICT The operation was changed elsewhere since it was read.
STORE The local database could not be read or written.
RESUME_UNCONFIRMED Resuming would send again a step that does not only read, and that was not confirmed.

Sending: the network and TLS

Code Means
TRANSPORT_HOST_NOT_FOUND The host name could not be resolved: check its spelling, DNS or VPN.
TRANSPORT_REFUSED The connection was refused: is the service running, on that port?
TRANSPORT_CONNECT_TIMEOUT No connection in time: check the address, a firewall or VPN.
TRANSPORT_CONNECT, TRANSPORT_EXCHANGE The connection or the exchange failed, with the reason.
TRANSPORT_RESPONSE_TIMEOUT The connection was accepted, and the response did not finish in time.
TRANSPORT_CERTIFICATE_UNTRUSTED The certificate is not one this computer trusts: add your organization's authority under Connections.
TRANSPORT_CERTIFICATE_NAME The certificate does not name the host in the address.
TRANSPORT_CERTIFICATE The certificate was refused for another reason, such as expiry.
TRANSPORT_CLIENT_CERTIFICATE_REFUSED, TRANSPORT_CLOSED_BY_SECURE_SERVER The server wants a client certificate, and none was presented or not one it accepts.
TRANSPORT_CLIENT_CERTIFICATE, TRANSPORT_AUTHORITY A client certificate and key, or an authority's file, cannot be read.
TRANSPORT_PROXY_ADDRESS, TRANSPORT_PROXY_UNREACHABLE The proxy's address is not usable, or the proxy could not carry the request. It was not sent directly.
TRANSPORT_SSH_TUNNEL The SSH route could not be opened or could not carry the request. Nothing was sent directly.
TRANSPORT_ADDRESS_REFUSED The host resolves to an address of the server's own network or a cloud's metadata service, which a server or agent does not send to unless its operator allows that network. Nothing was sent.
TRANSPORT_CHANNEL A message channel (Kafka, MQTT, AMQP, WebSocket, SSE) could not be used.
TRANSPORT_SETUP The HTTP client could not be set up.
TRANSPORT_NTLM NTLM's handshake could not be made: the account is not a Windows account name, or the server's challenge cannot be read. A wrong password is the server's 401.
TRANSPORT_KERBEROS No Kerberos ticket could be had, said plainly: the account is not user@REALM; the KDC cannot be reached at the address given; it refused the password, knows no such account, or knows no service HTTP/ and the address's host (the host is not one of the server's names in the domain, its SPN); or this computer's clock and the KDC's differ by more than five minutes.
TRANSPORT_DIGEST The server's Digest challenge cannot be answered: it names no nonce, asks for an algorithm other than MD5 or SHA-256 (each also -sess), or asks only for qop=auth-int; or a streamed response was asked for, which is not sent with Digest. A wrong password is the server's 401.
TRANSPORT_MCP An MCP server could not be reached, started or asked: its address cannot be read (an mcp+stdio: command with no program, or open quotes), the program could not be started, the server refused (a 401 says the credential), did not answer within 30 seconds, or refused the tool call; or the credential signs each request, which an MCP server's requests cannot be.
TRANSPORT_RECORDING_PROXY, TRANSPORT_BUCKET, TRANSPORT_DIRECTORY The recording proxy, the evidence bucket, or the LDAP directory could not be used.

The request itself

Code Means
REQUEST_URL_EMPTY, REQUEST_URL_INVALID, REQUEST_URL_SCHEME, REQUEST_URL_HOST The address is empty, not an address, not http or https, or has no host.
REQUEST_HEADER_NAME, REQUEST_HEADER_VALUE A header's name or value cannot be sent.
REQUEST_BODY_JSON A JSON body is not JSON once its variables are filled.
REQUEST_VARIABLES A {{variable}} has no value in the chosen environment. Add it on the Variables tab and save, or give it to a command-line run with --var name=value.
REQUEST_CREDENTIAL_HEADER_TWICE The request uses a credential and also sets that header itself.
REQUEST_FILE_NOT_GIVEN A multipart part sends a file, and no file was handed over for it.
REQUEST_UNSIGNED The request uses an AWS Signature Version 4 credential and sends what cannot be signed: a multipart body, a WebSocket or a gRPC call. Send it without the credential, or with a body that is read whole.
REQUEST_NOT_SENDABLE A request written in the browser could not be made into one to send, with the reason.
REQUEST_STOPPED A request was under way when the run ran out of time or was cancelled; it may have reached the API.

Credentials and destinations, on a server or an agent

Code Means
DESTINATION_NOT_ALLOWED The address is not among the origins the server's (or agent's) operator allows.
AGENT_NOT_TAKEN A request written in the browser waited a minute and the environment's agent did not take it: the agent may be stopped. Nothing was sent.
AGENT_LOST The environment's agent took a request written in the browser and did not answer within two minutes. It may have been sent, and is not sent again.
CREDENTIAL_NOT_FOR_DESTINATION The credential's binding does not name this origin among those it may be sent to.
CREDENTIAL_NOT_USABLE The environment binds no usable credential of that name, or its secret does not open. On this computer: an operation's request names a credential this computer has none of; add one of that name under Connections.
CREDENTIAL_TOKEN_REFUSED An OAuth client's token endpoint refused, with its error and error_description.
CREDENTIAL_VAULT_REFUSED The credential could not be read from the vault, with Vault's reason.
CREDENTIAL_NOT_SIGNED_IN The credential is one each person signs in for themselves, and the person the run is for has not signed it in, or the run is not one a person asked for. Sign in from your Account page.
RATE_NOT_KEPT The shared rate limit to that origin could not be kept (an agent could not ask the server for its turn).
UPLOAD_GONE A file input's upload expired or was removed. Upload it again.
AGENT_LOST The agent running it was not heard from for two minutes. It is not sent again: it may have changed something already.
AGENT_REVOKED The agent running it was revoked.
PRINCIPAL_REVOKED, PRINCIPAL_OUT_OF_REACH A schedule's service token was revoked, or no longer reaches the operation in that environment.

The server's answers

The server answers an error as {"error": {"code": "…", "message": "…"}}.

Code Status Means
UNAUTHENTICATED 401 No valid service token or session was sent.
SIGN_IN_REFUSED 401 The identity token was not accepted.
SIGN_IN_UNAVAILABLE 404 The server has no identity provider: use a service token.
RATE_LIMITED 429 This token or session made more requests in a minute than the server allows (REQLYN_API_PER_MINUTE, 1,200 unless set). Retry-After says how many seconds until the next is taken.
FORBIDDEN 403 Your role does not allow this; the message says which role it needs.
NOT_YOURS 403 A comment is changed or removed only by its author, and a thread resolved only by who opened it or someone who may edit.
CSRF_TOKEN 403 A change asked by a browser's session cookie without the session's CSRF token: it did not come from Reqlyn's own page. Reload the page.
NO_WORKSPACE 403 You are signed in and hold no role in any workspace here.
NOT_FOUND 404 No such thing, or not one you reach.
INVALID 422 What was sent is not valid, with why.
BINDINGS_MISSING 422 The environment does not bind what the version needs.
CASES_DO_NOT_HOLD 422 A regression case does not hold, so the version is not activated.
NOT_ACTIVATED 409 The version is not activated in that environment.
VERSION_DISABLED, VERSION_RETIRED 409 The version is disabled, or retired and activated nowhere new.
DRAFT_CONFLICT 409 The draft changed since the revision this was made from. Read it again.
IDEMPOTENCY_CONFLICT 409 That idempotency key was used with another input or environment.
SYNC_CONFLICT 409 Another device kept a later revision of this synchronized object first.
LAST_ADMINISTRATOR 409 That would leave the workspace without an administrator.
RESUME_UNCONFIRMED 409 Resuming sends a step that writes again: ask with it confirmed.
ROUTE_STILL_RUNNING 504 A route's run is still under way after 30 seconds; read it at status_url.
QUEUE_FULL 429 The workspace has as many runs waiting as the server holds. Try again (Retry-After).
SERVER_BUSY 503 Every database connection was in use. Try again in a moment.
DATABASE_UNREACHABLE 503 The server cannot reach its database, and what was asked needs it. Routes may still be answered.
SERVER_DATABASE, SERVER_KEY_MISSING 503 The database cannot be reached; the server has no installation key.
EVIDENCE_GONE, EVIDENCE_UNREADABLE 410 A kept body's file is gone, or the installation key does not open it. The run is as it was.
CREDENTIAL_NOT_FOR_DESTINATION, VAULT_REFUSED — As above, when a binding is checked or read.
IDENTITY_PROVIDER, DIRECTORY 502 The identity provider or the LDAP directory could not be asked.
GIT_FETCH_FAILED 502 The workspace's Git remote could not be fetched, with what git said; never its token.
RECOVERY_EXISTS, RECOVERY_UNAVAILABLE — A recovery credential exists already, or none was made.
WORKSPACE_EXISTS, WORKSPACE_NOT_FOUND, NAME_NEEDED — From reqlyn-server workspace and token commands.

When the server will not start

Code Means
SERVER_SETTING_MISSING, SERVER_SETTING_BAD A setting is missing or cannot be used; the message names it.
SERVER_MIGRATIONS_PENDING The database is at an older schema: run reqlyn-server migrate. Nothing migrates by itself.
SERVER_SCHEMA_AHEAD The database was made by a newer server. Run that version.
SERVER_KEY_MISSING, SERVER_KEY_UNUSABLE REQLYN_KEY_FILE is not set, or its key cannot be used.
SECRET_UNSEALABLE A secret was sealed under another installation key, or altered. See KEY_RECOVERY.md.
SERVER_ANOTHER_OWNER Another server holds this database's queue.
SERVER_LISTEN, SERVER_STOPPED, SERVER_NO_RANDOMNESS It could not listen, stopped, or got no random bytes.

Help for Reqlyn 0.5.1. All help topics