Error codes

The platform and the worker SDKs talk in numeric result codes attached to every message. These are the codes you set explicitly via setStopProcess(...), plus the ones the platform sets on your behalf when something goes wrong.

For language-specific enums see Node.js / ResultCode and PHP / ProcessDtoAbstract.

Success and routing (set by your code) #

CodeNameMeaning
0SUCCESSContinue to the next node.
1001REPEATRe-deliver this exact message to the same node.
1002FORWARD_TO_TARGET_QUEUERoute to a named successor instead of the default one.
1003DO_NOT_CONTINUEEnd this branch successfully.
1006STOP_AND_FAILEDMark the message as failed; goes to Trash after retries.

Batch (set by ABatchNode / BatchAbstract) #

CodeNameMeaning
1010BATCH_CURSOR_WITH_FOLLOWERSIterate again; emit accumulated items downstream now.
1011BATCH_CURSOR_ONLYIterate again; hold items until iteration completes.

Platform-managed #

CodeNameMeaning
1004LIMIT_EXCEEDEDLimiter held the message back. The platform retries when a token is available.

Failure reporting (set by the platform) #

CodeNameMeaning
2001UNKNOWN_ERRORGeneric failure (e.g. uncaught exception).
2002INVALID_HEADERSRequired headers were missing on inbound message.
2003INVALID_CONTENTMessage body was not parsable.

HTTP status code conventions #

The worker REST API itself follows standard HTTP semantics:

StatusMeaning
200The node ran. The body contains the outbound ProcessDto, which itself carries the result code above.
400Malformed request from the platform (extremely rare; would indicate an SDK or platform bug).
404Unknown component id; the worker doesn't have this connector / node / batch.
500Uncaught exception inside the worker. The platform translates this to UNKNOWN_ERROR.

See also #

© 2025 Orchesty Solutions. All rights reserved.