Error messages
Understand the errors that could occur when working with Orchestra APIs
HTTP 400 (validation) errors
All validation error codes have the following standard format: ERxxxx, where xxxx represents an integer between 0 and 9999.
Validation errors could occur when doing the following:
Errors when initializing group interactions
API: POST /api/v2/Interaction/group/InitializeInteraction
ER0001
Insufficient participants.
Please add at least 2 participants with unique and active interaction sessions.
Group interactions require a minimum of 2 participants. This error occurs if you try to initialize a group interaction with less than two participants.
ER0002
One or more interaction sessions have already been used in other interactions.
Please add only participants who have unique interaction session IDs.
Group interactions require unique interaction session IDs for each participant; the same interaction session cannot be used multiple times. This error occurs if you try to initialize a group interaction in which a participant's interaction session were used before.
ER0003
One or more participants have interaction sessions that have ended.
Please add at least 2 participants with active interaction sessions.
All participants in group interactions must have active interaction sessions, which means the sessions should not have already ended. This error occurs if you try to initialize a group interaction between participants who have interaction sessions that have ended.
ER0004
Interaction sessions are from different projects.
Please add only participants who have active interaction sessions in the same project.
All participants in group interactions must have active interaction sessions from the same project. This error occurs if you try to initialize a group interaction between participants who have interaction sessions from different projects.
ER0005
One or more interaction sessions are from a different active group interaction.
Please dissolve other group interactions of each participant before inviting them to the current one.
None of the participants' interaction sessions in a group interaction must belong to any other active group interaction.
If a participant was previously part of a different group interaction, you must dissolve that interaction before trying to add them to the current group interaction. This error occurs if you try to initialize a group interaction with a participant whose interaction session belongs to a different active group interaction.
ER0006
Participants are of different types.
Please add only participants of the same type; either all real human users or all EDNPCs.
All participants in a group interaction must be of the same type, i.e. either all real human end-users or all EDNPCs. This error occurs if you try to initialize a group interaction between end-users and EDNPCs.
ER0055
{Comma-separated Session IDs} are from a different active group interaction.
Please dissolve the other group interaction before inviting the participants to the current one.
None of the participants' interaction sessions in a group interaction must belong to any other active group interaction.
If a participant was previously part of a different group interaction, you must dissolve that interaction before trying to add them to the current group interaction. This error occurs if you try to initialize a group interaction with participants whose interaction sessions belongs to other active group interactions. The error lists the interaction session IDs that are causing the issue.
Errors when dissolving group interactions
API: POST /api/v2/Interaction/group/DissolveInteraction
ER0007
Invalid group ID.
Please enter a valid and active interaction group ID.
You can dissolve only valid and active group interactions. This error occurs if you try to dissolve:
A group interaction based on an invalid group ID
An inactive (previously-dissolved) group interaction.
When initializing interaction sessions
API: POST /api/v2/Interaction/InitializeSession
ER0008
Invalid user ID.
Please enter a valid user ID that belongs to the current tenant account.
You can initialize interaction sessions only using a valid (existing) user ID that belongs to the tenant account currently logged in. This error occurs if you try to initialize an interaction session using a user ID that doesn't exist or belongs to a different tenant account.
ER0009
Invalid entity ID.
Please enter a valid entity ID that is part of the current project.
To initialize an interaction session, you must enter a valid entity ID that belongs to the current project. This error occurs if you try to initialize an interaction session using an invalid entity ID or one that belongs to a different project.
ER0010
Missing external user ID or entity ID.
Please enter a valid external user ID or entity ID to initialize a new session.
To initialize an interaction session, you must enter either an external user ID or entity ID. This error occurs if you try to initialize an interaction session without entering either of these two values.
ER0011
Invalid project ID.
Please enter a valid project ID.
To initialize an interaction session, you must enter a valid project ID. This error occurs if you try to initialize an interaction session by entering an invalid project ID.
ER0012
Missing entity ID.
As this is a simulation project, to initialize a session, please enter an entity ID.
In projects that have simulation or simulation_bulk as their purpose, you must enter an entity ID when initializing interaction sessions. As simulation can only be performed with EDNPCs and not real human end-users, you cannot initialize a session using an external user ID. This error occurs if you try to initialize an interaction session in a simulation project without providing an entity ID.
ER0013
Missing external user ID.
As this is a data collection project, to initialize a session, please enter an external user ID.
In projects that have data collection as their purpose, you must enter an external user ID when initializing interaction sessions. As raw data collection (RDC) can only be performed with real human end-users and not with EDNPCs, you cannot initialize a session using an entity ID. This error occurs if you try to initialize an interaction session in a data collection project without providing an external user ID.
ER0014
Invalid values entered.
Please enter either an external user ID (for data collection projects) or entity ID (for simulation projects), not both.
Based on the project's purpose, you must enter either an external user ID or an entity ID when initializing interaction sessions. Raw data collection (RDC) can only be performed with real human users, and therefore, for these projects, you must enter only external user IDs when initializing interaction sessions. On the other hand, simulation can only be performed with EDNPCs and therefore, for these projects, you must enter only entity IDs when initializing interaction sessions. This error occurs if you try to initialize an interaction session by entering both an external user ID and an entity ID.
ER0082
You must summon the Entity before start using it
This error occurs if you try to initialize an interaction session using an entity without first summoning the entity.
ER0083
The Entity provided is not Online, consider summoning the entity first
This error occurs if you try to initialize a session using an entity ID of an offline entity.
Errors during interactions
API: POST /api/v2/Interaction/Interact
ER0015
An error occurred when converting voice (base64) to the required frequency.
This error is displayed if an unknown error occurs when converting the provided voice audio (base64) to the required frequency.
ER0016
Invalid group ID.
Please enter a valid group ID of an active group interaction.
When performing a group interaction, you must enter a valid and active group ID. This error occurs if you provide an invalid group ID or the group ID of a previously-dissolved group interaction.
ER0017
The current interaction session was not added to the group interaction.
This error occurs if the current interaction session was not added to the group interaction during its initialization. This error is not related to the validity of the group ID of the group interaction; it could occur even if the group ID you entered is valid.
ER0018
One or more entity object IDs are invalid.
Please enter valid, non-null entity object IDs.
You must enter valid values for the entity_Object_ID parameter. This error occurs if you enter an incorrect entity object ID or null value.
ER0019
One or more triggered action feeding data IDs are invalid.
Please enter valid, non-null triggered action feeding data IDs.
You must enter valid values for the triggeredAction_FeedingData_ID parameter. This error occurs if you enter an incorrect feeding data ID or null value.
ER0020
Missing interaction type.
Please enter one of the following values for the Interact_Type parameter: text, voice, qr, external_signal, passive
When performing interactions, you must enter a valid interaction type. You can enter one of the following values:
text
voice
qr
external_signal
passive
This error occurs if you do not enter any value or enter a null value for the interact_Type parameter.
ER0021
Invalid interaction type.
Please enter only one of the following values for the Interact_Type parameter: text, voice, qr, external_signalllowed at the moment
When performing interactions, you must enter a valid interaction type. In this case, you can enter one of the following values:
text
voice
qr
external_signal
This error occurs if you do not enter an acceptable value for the interact_Type parameter.
ER0022
Invalid values entered.
As this is not a data collection project, please do not enter feeding data IDs.
You can feed data only in projects that have data collection as their purpose. This error occurs if you enter a value for the feedingDataId parameter for a project that has a different purpose.
ER0024
Invalid feeding data ID.
Please enter a valid feeding data ID that is part of the current project.
When feeding data in a project, the feeding data ID must be valid and belong to the same project. This error occurs if you enter an invalid feeding data ID or one that doesn't belong to the current project.
ER0025
TMissing BPM or EEG inputs.
As this is not a simulation project, please provide EEG or BPM (heartbeat) inputs for the interaction.
In interaction sessions in data collection (or other non-simulation) projects, you must provide EEG or BPM (heartbeat) input. This error occurs if you do not provide either of these inputs.
ER0026
Next participant not selected.
As this is a directed group interaction, please enter the next participant’s interaction session ID in Next_Participant_InteractionSession.
In directed group interactions, you need to select the participant who interacts next. You must do this by entering the participant's interaction session ID in the Next_Participant_InteractionSession parameter. This error occurs if you do not enter a value for this parameter.
ER0027
Invalid values entered.
As this is an automated group interaction, please enter a null value in Next_Participant_InteractionSession to enable EDAA to select the next participant.
Automated group interactions are directed by EDAA™, which means that EDAA™ selects the participant who interacts next. To enable EDAA™ to do this, you must enter a null value in the Next_Participant_InteractionSession parameter. This error occurs if you do not enter a null value for the parameter.
ER0028
Invalid source interaction entity ID.
In source_interaction_entity_id, please enter a valid source interaction entity ID that is of type EDNPC and part of the current project.
When performing an interaction, you must enter a source interaction entity ID of type EDNPC and part of the current project. This error occurs if you enter a source interaction entity ID that does not meet these requirements.
ER0029
Missing source interaction entity ID.
As the current session belongs to an Environment entity, please enter the source interaction entity ID in source_interaction_entity_id.
In interaction sessions of Environment entities, you must enter a source interaction entity ID. This error occurs if you do not enter a source interaction entity ID for Environment entity interaction sessions.
ER0030
Invalid EEG values.
Please provide only 5-channel EEG inputs.
Only 5-channel EEG input is currently supported. This error occurs if you provide EEG input with a different number of channels.
ER0031
Unable to convert audio (base64) to text due to no voice or high noise level.
This error occurs if the audio (base64) provided has no voice or a very high level of noise, due to which it cannot be converted to text.
ER0032
Invalid interaction session ID.
Please enter a valid session ID of entity type Interaction.
When performing an interaction, you must enter a valid session ID of entity type Interaction. This error occurs if you do not provide a valid interaction session ID.
ER0033
Missing BPM input.
Please provide a valid BPM (heartbeat) input for the interaction.
When performing an interaction in projects configured to accept BPM (heartbeat) input, you must provide valid BPM values.
This error occurs if the value of the BPM input is zero.
ER0034
Invalid BPM input values.
Please provide a valid BPM (heartbeat) input within the normal heartbeat range for the interaction.
When performing an interaction in projects configured to accept BPM (heartbeat) input, you must provide valid BPM values.
This error occurs if the value of the BPM input exceeds the normal range.
ER0035
Missing EEG input.
Please provide a valid EEG input for the interaction.
When performing an interaction in projects configured to accept EEG input, you must provide valid EEG values. This error occurs if no value is provided for EEG input.
ER0036
Missing motivation vector.
Please set up the motivation vector for the project.
This error occurs if the project's motivation vector is not set up.
ER0037
Incomplete user diagnostics.
When user diagnostics is completed for a participant, EDAA™ establishes their preliminary psychological profile, which is subsequently updated as the participant performs interactions. This profile is required when beginning an action or user calibration interaction. If a participant doesn't have a profile, it means that the diagnostics process was not completed for them. This error occurs when performing an interaction using an interaction session ID of a participant who doesn't have a profile.
ER0038
Unexpected interaction mode.
Please perform this interaction in user_calibration mode.
This error occurs if the current interaction needs to be perfromed in user calibration mode.
ER0039
Unexpected interaction mode.
Please perform this interaction in product_calibration mode.
This error occurs if the current interaction needs to be perfromed in product calibration mode.
ER0040
EDNPC profile not found.
This error occurs if EDAA™ is unable to find the profile of the EDNPC participating in an interaction.
ER0041
User profile not found.
This error occurs if EDAA™ is unable to find the profile of the user participating in an interaction.
ER0042
EEG input is not enabled for the project.
Please enable EEG input in the project setup.
In order to provide EEG input for an interaction, the project must be configured to accept it. This error occurs if you have provided EEG input without enabling it in the project setup.
ER0043
QR input is not enabled for the project.
Please enable QR input in the project setup.
In order to provide QR input for an interaction, the project must be configured to accept it. This error occurs if you have provided QR input without enabling it in the project setup.
ER0044
Unexpected interaction mode.
Please perform this interaction in a different mode as this is a simulation project and EDNPCs cannot interact in diagnostics mode.
In simulation projects, EDNPCs cannot interact in diagnostics mode.
This error occurs if you try to perform an interaction with an EDNPC in diagnostics mode.
ER0045
BPM (heartbeat) input is not enabled for the project.
Please enable BPM input in the project setup.
In order to provide BPM (heartbeat) input for an interaction, the project must be configured to accept it. This error occurs if you have provided BPM input without enabling it in the project setup.
ER0046
Project domain or function is new.
This error occurs if a project is created with a new domain or function ID as in this case, EDAA™ would not be prepared to process its requests.
ER0047
Missing or invalid interaction session ID.
Please enter a valid interaction session ID that is a non-null, non-zero, positive number in Interaction_Session.
When performing an interaction, you must enter a valid interaction session ID. This error occurs if you do not enter any value or enter a null value, zero, or a negative number in the Interaction_Session parameter.
ER0048
Missing interaction type.
Please enter an interaction type in Interact_Type.
When performing interactions, you must enter a valid interaction type.
This error occurs if you do not enter any value for the interact_Type parameter
ER0049
Missing interaction mode.
Please enter an interaction mode in Mode.
When performing interactions, you must enter a valid interaction mode. This error occurs if you do not enter any value for the Mode parameter.
ER0050
Invalid participant selected.
Please enter a valid interaction session ID that belongs to the same project for the next participant in Next_Participant_InteractionSession.
When selecting the next participant who interacts in directed group interactions, you must enter a valid interaction session ID. This error occurs if you enter an invalid interaction session ID or one that belongs to a different project in the Next_Participant_InteractionSession parameter.
ER0051
Invalid entity or interaction type.
As EDNPCs cannot interact using voice, please enter a different entity ID or interaction type.
Only real human users can interact using voice. This error occurs if you try to perform a voice interaction using an EDNPC.
ER0052
Source entity is not summoned.
Please summon the source entity to enable EDAA to create its psychological profile.
When performing interactions using a source entity, you must first summon it. This enables EDAA™ to create its physiological profile so that it can be used. This error occurs if you try to perform an interaction without first summoning the source entity.
ER0053
Source entity is not associated with any user ID.
Please summon the source entity by associating it with a user ID.
When performing interactions using a source entity, you must first summon the EDNPC and associate it with a user ID. This error occurs if the source entity is not associated with any user ID.
ER0054
Incomplete diagnostics for the user associated with the source entity.
Please complete the diagnostics for the associated user.
When performing interactions using a source entity that is associated with a user ID, you must first complete the diagnostics for the associated user. This error occurs if user diagnostics is not completed for the user associated with the source entity.
ER0057
Please ensure project has some verified actions
Only verified actions can be used in projects. This error occurs if the project has no verified actions.
ER0058
The interaction Session ID you provided already has been ended
You can perform interactions only by using active interaction session IDs. This error occurs if you try to perform an interaction using an interaction session that has already ended.
ER0059
Interact type object requires at least one object to be provided part of Objects_Status parameter
For an interaction of type object, you must provide at least one object. This error occurs if you have specified object as the interaction type but did not enter any object ID in the objects_Status parameter.
ER0060
Interact_Value Can't be Empty for the provided interaction type."
For interaction types that require an interaction value, you must enter a non-null value in the interact_value parameter. This error occurs if interact_value has a null value or is empty for interaction types that require it.
ER0061
Provided Entity ID does not belong to a project of type simulation.
Only entities that belong to simulation projects can interact during simulation events. This error occurs if during simulation, you try to perform an interaction using an entity ID that belongs to a project of a different type.
Errors when summoning EDNPCs
API: POST /api/v2/Interaction/SummonNPC
ER0056
Invalid user ID.
Please enter a valid user ID to summon the associated EDNPC.
This error occurs if you enter an invalid user ID when summoning an EDNPC.
Errors when adding interaction preferences
API: POST /api/v2/Interaction/AddInteractionPreferences
ER0063
Option name Already Exists
This error occurs if you try to create an interaction option using an option name that already exists.
Errors when starting data augmentation
API: POST /api/v2/Interaction/AddInteractionPreferences
ER0088
The associated data collection project {Project_ID} linked to this interaction does not contain at least 100 stages. Please ensure sufficient data has been collected before proceeding with the interaction.
To begin data augmentation for bulk simulation, the raw data collection (RDC) event must have at least 100 stages. This error occurs if you try to begin data augmentation when less than the required amount of data is collected.
Errors common to multiple API calls
The following errors are not specific to any single endpoint. They could occur if you try to perform the described action when calling any endpoint:
ER0064
Resource not found.
This error occurs if you try to retrieve a resource that wasn't found.
ER0065
Unauthorized Access.
This error occurs if you try to access a resource that you do not have the required permissions for.
ER0066
The provided NPC Id is invalid.
This error occurs if you provide an invalid entity ID for an NPC.
ER0067
Provided NPC is already killed.
This error occurs if, for any purpose, you try to use an NPC that is offline or inactive because it has been killed.
ER0068
Provided Project is not a simulation project.
This error occurs if you enter a project ID of the wrong project type.
ER0069
The provided Session Id is invalid.
This error occurs if you enter an invalid session ID
ER0070
The provided Session Id has no enough interactions/stages, it should be 2 at least.
This error occurs if you enter a session ID of a session that has less than the required minimum number of interactions or stages.
ER0071
The provided Session ID has no enough action/user_calibration interactions/stages, you can't start augmentation with diagnostics interaction only.
This error occurs if you try to start data augmentation for a session that has only diagnostic interactions.
ER0072
The provided Session ID should belong to a project of purpose Data_Collection.
This error occurs if you enter a session ID that doesn't belong to a data collection project.
ER0073
The provided Simulation Project ID is invalid.
This error occurs if you enter an invalid simulation project ID.
ER0074
The provided Session ID belongs to a user who belongs to another Tenant.
This error occurs if you enter a session ID of a project that belongs to a different tenant.
ER0075
The provided Session ID doesn't belong to a real-user interactions.
This error occurs if you enter an interaction session ID that doesn't belong to a real human user.
ER0076
The provided Session ID has no enough action/user_calibration interactions/stages, you can't start augmentation with diagnostics interaction only.
This error occurs if you try to start data augmentation for a session that has only diagnostic interactions.
ER0077
The provided Simulation Project ID should belong to a project of purpose Simulation Bulk.
This error occurs if you enter a simulation project ID that doesn't belong to a bulk simulation project.
ER0078
The provided Patch ID is invalid.
This error occurs if you enter an invalid patch ID
ER0079
The provided External UserID is not valid, Please check & try again.
This error occurs if you enter an invalid external user ID.
ER0080
Error occured while trying to broadcast.
This error occurs if there is an issue during broadcasting data.
ER0081
The provided Entity Id does not have any data.
This error occurs if you enter an entity ID of an entity that doesn't have any data.
ER0084
This Entity already reached offline state, consider using new Entity.
This error occurs if you enter an entity ID of an offline entity.
ER0085
This Entity already reached online state, you can use it without summoning again
This error occurs if you try to summon an entity that is already online.
ER0086
Provided EntityID does not belong to a project of type simulation
This error occurs if you enter an entity ID that doesn't belong to a simulation project.
ER0087
Provided EntityID is not valid
This error occurs if you enter an invalid entity ID.
HTTP 500 (internal server) error
Internal server errors can occur for miscellaneous reasons and always have the following format:
EX0001
Internal Server Error Occurred
If multiple internal server errors occur, incremental error codes are displayed (EX0002, EX0003, ... EX000n).
Last updated
Was this helpful?