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