Error Codes

This page depicts the various Error codes that Axon Server will return in the case of any problems while Processing Client Requests / Message Handling / Administrative Tasks / Cluster Errors.

Client request processing errors

Error Code	Error	Description
AXONIQ-1000	AUTHENTICATION TOKEN MISSING	This indicates that the Axon Server has been configured with authentication enabled and a client application did not pass a token.
AXONIQ-1001	AUTHENTICATION INVALID TOKEN	This indicates that the Axon Server has been configured with authentication enabled and a client application has supplied an invalid token.
AXONIQ-1002	UNSUPPORTED INSTRUCTION	This error is returned when the Axon Server cannot recognize the instruction passed to it.
AXONIQ-1003	INSTRUCTION EXECUTION ERROR	This error is returned when the Axon Server throws an error during the execution of the instruction passed to it.
AXONIQ-1004	INSTRUCTION RESULT TIMEOUT	This indicates that the execution of the instruction did not finish within the timeout set.
AXONIQ-1100	NODE IS REPLICA	This error is returned when a request from a node to join a cluster is received by a node that is no longer leader. Normally the node would forward the request to the leader, but if there is a leader change during the processing of the join request this may happen.
AXONIQ-1300	NO SUCH APPLICATION	This error is returned when any client sends any instruction with a specific application name that has not been registered with Axon Server.
AXONIQ-1301	NO SUCH NODE	This error is returned when any client sends any instruction with a specific node name that has not been registered with Axon Server.
AXONIQ-1302	CONTEXT NOT FOUND	This error is returned when any client sends any instruction with a specific context that has not been registered with Axon Server.
AXONIQ-1304	CONTEXT EXISTS	This error is returned when there is an instruction to create a specific context within Axon Server and it already exists.
AXONIQ-1305	REPLICATION GROUP EXISTS	This error is returned when there is an instruction to create a specific replication group within Axon Server and it already exists.
AXONIQ-1400	NO AXONSERVER FOR CONTEXT	This error is returned when there is no Axon Server node available for the specified context.
AXONIQ-1500	AXONSERVER NODE NOT CONNECTED	This error is returned when there is an instruction to create a specific context within Axon Server, and it already exists.
AXONIQ-1700	LICENSE ERROR	This error is returned when the request cannot be executed due to license restrictions.
AXONIQ-1900	TOO MANY REQUESTS	This error is returned when clients send too many commands or queries to Axon Server and its internal queue is full.

Error Code

Error

Description

AXONIQ-1000

AUTHENTICATION TOKEN MISSING

This indicates that the Axon Server has been configured with authentication enabled and a client application did not pass a token.

AXONIQ-1001

AUTHENTICATION INVALID TOKEN

This indicates that the Axon Server has been configured with authentication enabled and a client application has supplied an invalid token.

AXONIQ-1002

UNSUPPORTED INSTRUCTION

This error is returned when the Axon Server cannot recognize the instruction passed to it.

AXONIQ-1003

INSTRUCTION EXECUTION ERROR

This error is returned when the Axon Server throws an error during the execution of the instruction passed to it.

AXONIQ-1004

INSTRUCTION RESULT TIMEOUT

This indicates that the execution of the instruction did not finish within the timeout set.

AXONIQ-1100

NODE IS REPLICA

This error is returned when a request from a node to join a cluster is received by a node that is no longer leader. Normally the node would forward the request to the leader, but if there is a leader change during the processing of the join request this may happen.

AXONIQ-1300

NO SUCH APPLICATION

This error is returned when any client sends any instruction with a specific application name that has not been registered with Axon Server.

AXONIQ-1301

NO SUCH NODE

This error is returned when any client sends any instruction with a specific node name that has not been registered with Axon Server.

AXONIQ-1302

CONTEXT NOT FOUND

This error is returned when any client sends any instruction with a specific context that has not been registered with Axon Server.

AXONIQ-1304

CONTEXT EXISTS

This error is returned when there is an instruction to create a specific context within Axon Server and it already exists.

AXONIQ-1305

REPLICATION GROUP EXISTS

This error is returned when there is an instruction to create a specific replication group within Axon Server and it already exists.

AXONIQ-1400

NO AXONSERVER FOR CONTEXT

This error is returned when there is no Axon Server node available for the specified context.

AXONIQ-1500

AXONSERVER NODE NOT CONNECTED

This error is returned when there is an instruction to create a specific context within Axon Server, and it already exists.

AXONIQ-1700

LICENSE ERROR

This error is returned when the request cannot be executed due to license restrictions.

AXONIQ-1900

TOO MANY REQUESTS

This error is returned when clients send too many commands or queries to Axon Server and its internal queue is full.

Input errors

Error Code	Error	Description
AXONIQ-2000	INVALID SEQUENCE	This error is returned when there is a gap between the sequence number for a particular aggregate instance that the client application sends and the current sequence number for that instance in the Axon Server Event Store.
AXONIQ-2001	PAYLOAD TOO LARGE	This error is returned when the payload for the message to be executed is too large.
AXONIQ-2002	TOO MANY EVENTS	This error is returned when an ad-hoc query (for example from the Search Page) has buffered too many rows to send to the client, this error also is returned when a single transaction from a client contains more than 32767 events (due to a limitation in the event store format, we can only store MAX_SHORT events in a single transaction).
AXONIQ-2100	NO LEADER AVAILABLE	This error is returned when no leader is available to execute any instruction sent to the Axon Server cluster.
AXONIQ-2101	NOT RUNNING IN CLUSTER	This error is returned when Axon Server is not running in a cluster.
AXONIQ-2107	REPLICATION GROUP UPDATE IN PROGRESS	This error is returned when an instruction on a specific replication group is rejected as it is undergoing an update.
AXONIQ-2108	REPLICATION GROUP NOT FOUND	This error is returned when an instruction is requested for a non-existing replication group.
AXONIQ-2200	INVALID TRANSACTION TOKEN	This error is returned when during replication there is a mismatch between the transaction token in the new transaction and the transaction token that the event store node expects. This means that there is a likely inconsistency in the data between the nodes.
AXONIQ-2301	CLUSTER NOT ALLOWED	This error is returned when an instruction to create a cluster is rejected.
AXONIQ-2302	CONTEXT CREATION NOT ALLOWED	This error is returned when an instruction to create a context on an Axon Server cluster is rejected due to invalid permissions.
AXONIQ-2303	NOT SUPPORTED IN DEVELOPMENT	This error is returned when an instruction valid only in non-development mode is attempted when development mode is active.
AXONIQ-2304	CANNOT DELETE INTERNAL CONTEXT	This error is returned when an operation to delete any internal context is attempted on an Axon Server cluster.
AXONIQ-2305	MAX CLUSTER SIZE REACHED	This error is returned when the maximum size of the cluster is reached.
AXONIQ-2306	ALREADY MEMBER OF CLUSTER	This error is returned when an attempt is made to add an already existing node to a cluster.
AXONIQ-2307	NOT A MEMBER	This error is returned when a cluster related instruction was sent to a node that is not a member of the cluster.
AXONIQ-2308	INVALID CONTEXT NAME	This error is returned when an instruction is attemped on a non-existing context.
AXONIQ-2310	CANNOT REMOVE LAST NODE	This error is returned when a user tries to remove the last node from a replication group. In this case, the user should delete the replication group.
AXONIQ-2311	INVALID PROPERTY VALUE	This error is returned in multiple conditions for example when creating a context with properties and one of the properties does not have a valid value, also when updating a license and the license file is invalid or the environment variable.
AXONIQ-2500	SAME NODE NAME	This error is returned when a node tries to join the cluster with the same internal hostname and port as the leader.
AXONIQ-2501	UNKNOWN HOST	This error is returned when a hostname was passed that did not resolve to a valid IP address.
AXONIQ-2502	CANNOT JOIN	This error is returned when a node tries to join the cluster and there is an error.
AXONIQ-2510	UNKNOWN ROLE	This error is returned when an unknown role is assigned to a user or application. This can only happen when this is done through the REST interface directly or through the CLI.
AXONIQ-2511	INVALID QUERY	This error is returned when the user sends a query in the search window that is not valid.
AXONIQ-2700	PLUGIN NOT FOUND	This error is returned when the user sends a request for a plugin that cannot be found.
AXONIQ-2701	INVALID PLUGIN CONFIGURATION	This error is returned when the user tries to update the configuration of a plugin with invalid values.
AXONIQ-2800	EVENT PROCESSOR NOT FOUND	This error is returned when the user tries to update the configuration of a non-existing event processor.
AXONIQ-2801	EVENT PROCESSOR MOVE UNKNOWN TARGET	This error is returned when the user tries to move an event processor segment to a client that is no longer connected.
AXONIQ-2802	EVENT PROCESSOR MOVE NO AVAILABLE THREADS	This error is returned when the user tries to move an event processor segment to a client that does not have any available threads.

Error Code

Error

Description

AXONIQ-2000

INVALID SEQUENCE

This error is returned when there is a gap between the sequence number for a particular aggregate instance that the client application sends and the current sequence number for that instance in the Axon Server Event Store.

AXONIQ-2001

PAYLOAD TOO LARGE

This error is returned when the payload for the message to be executed is too large.

AXONIQ-2002

TOO MANY EVENTS

This error is returned when an ad-hoc query (for example from the Search Page) has buffered too many rows to send to the client, this error also is returned when a single transaction from a client contains more than 32767 events (due to a limitation in the event store format, we can only store MAX_SHORT events in a single transaction).

AXONIQ-2100

NO LEADER AVAILABLE

This error is returned when no leader is available to execute any instruction sent to the Axon Server cluster.

AXONIQ-2101

NOT RUNNING IN CLUSTER

This error is returned when Axon Server is not running in a cluster.

AXONIQ-2107

REPLICATION GROUP UPDATE IN PROGRESS

This error is returned when an instruction on a specific replication group is rejected as it is undergoing an update.

AXONIQ-2108

REPLICATION GROUP NOT FOUND

This error is returned when an instruction is requested for a non-existing replication group.

AXONIQ-2200

INVALID TRANSACTION TOKEN

This error is returned when during replication there is a mismatch between the transaction token in the new transaction and the transaction token that the event store node expects. This means that there is a likely inconsistency in the data between the nodes.

AXONIQ-2301

CLUSTER NOT ALLOWED

This error is returned when an instruction to create a cluster is rejected.

AXONIQ-2302

CONTEXT CREATION NOT ALLOWED

This error is returned when an instruction to create a context on an Axon Server cluster is rejected due to invalid permissions.

AXONIQ-2303

NOT SUPPORTED IN DEVELOPMENT

This error is returned when an instruction valid only in non-development mode is attempted when development mode is active.

AXONIQ-2304

CANNOT DELETE INTERNAL CONTEXT

This error is returned when an operation to delete any internal context is attempted on an Axon Server cluster.

AXONIQ-2305

MAX CLUSTER SIZE REACHED

This error is returned when the maximum size of the cluster is reached.

AXONIQ-2306

ALREADY MEMBER OF CLUSTER

This error is returned when an attempt is made to add an already existing node to a cluster.

AXONIQ-2307

NOT A MEMBER

This error is returned when a cluster related instruction was sent to a node that is not a member of the cluster.

AXONIQ-2308

INVALID CONTEXT NAME

This error is returned when an instruction is attemped on a non-existing context.

AXONIQ-2310

CANNOT REMOVE LAST NODE

This error is returned when a user tries to remove the last node from a replication group. In this case, the user should delete the replication group.

AXONIQ-2311

INVALID PROPERTY VALUE

This error is returned in multiple conditions for example when creating a context with properties and one of the properties does not have a valid value, also when updating a license and the license file is invalid or the environment variable.

AXONIQ-2500

SAME NODE NAME

This error is returned when a node tries to join the cluster with the same internal hostname and port as the leader.

AXONIQ-2501

UNKNOWN HOST

This error is returned when a hostname was passed that did not resolve to a valid IP address.

AXONIQ-2502

CANNOT JOIN

This error is returned when a node tries to join the cluster and there is an error.

AXONIQ-2510

UNKNOWN ROLE

This error is returned when an unknown role is assigned to a user or application. This can only happen when this is done through the REST interface directly or through the CLI.

AXONIQ-2511

INVALID QUERY

This error is returned when the user sends a query in the search window that is not valid.

AXONIQ-2700

PLUGIN NOT FOUND

This error is returned when the user sends a request for a plugin that cannot be found.

AXONIQ-2701

INVALID PLUGIN CONFIGURATION

This error is returned when the user tries to update the configuration of a plugin with invalid values.

AXONIQ-2800

EVENT PROCESSOR NOT FOUND

This error is returned when the user tries to update the configuration of a non-existing event processor.

AXONIQ-2801

EVENT PROCESSOR MOVE UNKNOWN TARGET

This error is returned when the user tries to move an event processor segment to a client that is no longer connected.

AXONIQ-2802

EVENT PROCESSOR MOVE NO AVAILABLE THREADS

This error is returned when the user tries to move an event processor segment to a client that does not have any available threads.

Command handling errors

Error Code	Error	Description
AXONIQ-4000	NO HANDLER FOR COMMAND	This error is returned when a command message instruction is sent to the Axon Server and there is no corresponding handler available for it.
AXONIQ-4001	CONNECTION TO HANDLER LOST	This error is returned when Axon Server loses connection to any of the Command Handlers.
AXONIQ-4002	COMMAND TIMEOUT	This error is returned when a command message instruction is sent to the Axon Server and there is an error while processing it.
AXONIQ-4003	COMMAND DISPATCH ERROR	This error is returned when a command message instruction is sent to the Axon Server and there is an error while dispatching it.
AXONIQ-4005	COMMAND DUPLICATED	This error is returned when a command with the same message identifier is sent multiple times.

Error Code

Error

Description

AXONIQ-4000

NO HANDLER FOR COMMAND

This error is returned when a command message instruction is sent to the Axon Server and there is no corresponding handler available for it.

AXONIQ-4001

CONNECTION TO HANDLER LOST

This error is returned when Axon Server loses connection to any of the Command Handlers.

AXONIQ-4002

COMMAND TIMEOUT

This error is returned when a command message instruction is sent to the Axon Server and there is an error while processing it.

AXONIQ-4003

COMMAND DISPATCH ERROR

This error is returned when a command message instruction is sent to the Axon Server and there is an error while dispatching it.

AXONIQ-4005

COMMAND DUPLICATED

This error is returned when a command with the same message identifier is sent multiple times.

Query handling errors

Error Code

Error

Description

AXONIQ-5000

NO HANDLER FOR QUERY

This error is returned when a query message instruction is sent to the Axon Server and there is no corresponding handler available for it.

AXONIQ-5002

QUERY DISPATCH ERROR

This error is returned when a query instruction is sent to the Axon Server and there is an error while dispatching it.

AXONIQ-5006

QUERY TIMEOUT

This error is returned when a query takes too long.

AXONIQ-5007

QUERY DUPLICATED

This error is returned when a query with the same message identifier is sent multiple times.

Plugin errors

Error Code	Error	Description
AXONIQ-3004	EVENT REJECTED BY INTERCEPTOR	This error is returned when an interceptor in a plugin rejects an event.
AXONIQ-3005	SNAPSHOT REJECTED BY INTERCEPTOR	This error is returned when an interceptor in a plugin rejects a snapshot.
AXONIQ-4004	COMMAND REJECTED BY INTERCEPTOR	This error is returned when an interceptor in a plugin rejects a command.
AXONIQ-5004	QUERY REJECTED BY INTERCEPTOR	This error is returned when an interceptor in a plugin rejects a query.
AXONIQ-5005	SUBSCRIPTION QUERY REJECTED BY INTERCEPTOR	This error is returned when an interceptor in a plugin rejects a subscription query request.
AXONIQ-6100	EXCEPTION IN INTERCEPTOR	This error is returned when an interceptor in a plugin throws an exception.
AXONIQ-6101	POST COMMIT HOOK EXCEPTION	This error is returned when an post commit hook in a plugin throws an exception.

Error Code

Error

Description

AXONIQ-3004

EVENT REJECTED BY INTERCEPTOR

This error is returned when an interceptor in a plugin rejects an event.

AXONIQ-3005

SNAPSHOT REJECTED BY INTERCEPTOR

This error is returned when an interceptor in a plugin rejects a snapshot.

AXONIQ-4004

COMMAND REJECTED BY INTERCEPTOR

This error is returned when an interceptor in a plugin rejects a command.

AXONIQ-5004

QUERY REJECTED BY INTERCEPTOR

This error is returned when an interceptor in a plugin rejects a query.

AXONIQ-5005

SUBSCRIPTION QUERY REJECTED BY INTERCEPTOR

This error is returned when an interceptor in a plugin rejects a subscription query request.

AXONIQ-6100

EXCEPTION IN INTERCEPTOR

This error is returned when an interceptor in a plugin throws an exception.

AXONIQ-6101

POST COMMIT HOOK EXCEPTION

This error is returned when an post commit hook in a plugin throws an exception.

Backup errors

Error Code	Error	Description
AXONIQ-7000	NODE NOT READY FOR BACKUP	This error is returned when an Axon Server node is not available for any backup operation.

Error Code

Error

Description

AXONIQ-7000

NODE NOT READY FOR BACKUP

This error is returned when an Axon Server node is not available for any backup operation.

Internal errors

Error Code	Error	Description
AXONIQ-9000	DATAFILE READ ERROR	This error is returned when Axon Server is unable to read from the Event/Snapshot Data Files.
AXONIQ-9001	INDEX READ ERROR	This error is returned when Axon Server is unable to read from the Index files.
AXONIQ-9100	DATAFILE WRITE ERROR	This error is returned when Axon Server is unable to write to the Event/Snapshot Data files.
AXONIQ-9101	INDEX WRITE ERROR	This error is returned when Axon Server is unable to write to the Index files.
AXONIQ-9102	DIRECTORY CREATION FAILED	This error is returned when Axon Server is unable to create a directory for storing events/snapshots or indexes.
AXONIQ-9200	VALIDATION FAILED	This error is returned during startup of Axon Server when it performs a validation of the most recent event store segments. This error code is returned when the validation fails.
AXONIQ-9900	TRANSACTION ROLLED BACK	This error is returned when any transaction is rolled back.
AXONIQ-9500	INTERRUPTED	This error is returned when Axon Server process is stopped while waiting for events to be written to the event store segment.
AXONIQ-6000	NO EVENTSTORE	This error is returned when the Axon Server Event Store is not available to perform any instructions.
AXONIQ-6001	CLIENT DISCONNECTED	This error is returned when an Axon Framework client application disconnects from the Axon Server.
AXONIQ-6002	LIST AGGREGATE EVENTS TIMEOUT	This error is returned when a request to return the events for a specific aggregate takes too long.

Error Code

Error

Description

AXONIQ-9000

DATAFILE READ ERROR

This error is returned when Axon Server is unable to read from the Event/Snapshot Data Files.

AXONIQ-9001

INDEX READ ERROR

This error is returned when Axon Server is unable to read from the Index files.

AXONIQ-9100

DATAFILE WRITE ERROR

This error is returned when Axon Server is unable to write to the Event/Snapshot Data files.

AXONIQ-9101

INDEX WRITE ERROR

This error is returned when Axon Server is unable to write to the Index files.

AXONIQ-9102

DIRECTORY CREATION FAILED

This error is returned when Axon Server is unable to create a directory for storing events/snapshots or indexes.

AXONIQ-9200

VALIDATION FAILED

This error is returned during startup of Axon Server when it performs a validation of the most recent event store segments. This error code is returned when the validation fails.

AXONIQ-9900

TRANSACTION ROLLED BACK

This error is returned when any transaction is rolled back.

AXONIQ-9500

INTERRUPTED

This error is returned when Axon Server process is stopped while waiting for events to be written to the event store segment.

AXONIQ-6000

NO EVENTSTORE

This error is returned when the Axon Server Event Store is not available to perform any instructions.

AXONIQ-6001

CLIENT DISCONNECTED

This error is returned when an Axon Framework client application disconnects from the Axon Server.

AXONIQ-6002

LIST AGGREGATE EVENTS TIMEOUT

This error is returned when a request to return the events for a specific aggregate takes too long.

Cluster errors

Error Code	Error	Description
AXONIQ-10001	SERVER TOO SLOW	This error is returned when any instruction to update the Axon Server cluster fails as the server is too slow to respond.
AXONIQ-10002	UNCOMMITTED CONFIGURATION	This error is returned when an instruction to update configuration for the Axon Server cluster fails.
AXONIQ-10007	UNCOMMITTED TERM	Update the configuration of a replication group is received before there are any actions committed. The request is refused to prevent potential replication issues.
AXONIQ-10003	REPLICATION TIMEOUT	This error is returned when the replication process between the nodes of the Axon Server cluster times out.

Error Code

Error

Description

AXONIQ-10001

SERVER TOO SLOW

This error is returned when any instruction to update the Axon Server cluster fails as the server is too slow to respond.

AXONIQ-10002

UNCOMMITTED CONFIGURATION

This error is returned when an instruction to update configuration for the Axon Server cluster fails.

AXONIQ-10007

UNCOMMITTED TERM

Update the configuration of a replication group is received before there are any actions committed. The request is refused to prevent potential replication issues.

AXONIQ-10003

REPLICATION TIMEOUT

This error is returned when the replication process between the nodes of the Axon Server cluster times out.

Other errors

Error Code	Error	Description
AXONIQ-0001	OTHER	Any other errors.
AXONIQ-2610	SCHEDULED EVENT NOT FOUND	This error is returned when a scheduled event is not found.
AXONIQ-11000	INSTRUCTION TIMEOUT	This error is returned when an instruction sent to a client takes too long to complete.
AXONIQ-11001	INSTRUCTION ACK ONLY	This error is returned when an instruction is sent to a client which only acknowledges the request, but does not confirm the result of the instruction.

Error Code

Error

Description

AXONIQ-0001

OTHER

Any other errors.

AXONIQ-2610

SCHEDULED EVENT NOT FOUND

This error is returned when a scheduled event is not found.

AXONIQ-11000

INSTRUCTION TIMEOUT

This error is returned when an instruction sent to a client takes too long to complete.

AXONIQ-11001

INSTRUCTION ACK ONLY

This error is returned when an instruction is sent to a client which only acknowledges the request, but does not confirm the result of the instruction.