# Response codes

> The Orchestrator API attempts to return appropriate [HTTP status codes](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) for every request.

The Orchestrator API attempts to return appropriate [HTTP status codes](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) for every request.

On top of those, the Orchestrator API also returns some custom error codes. The table below describes each of these errors and when you can encounter them.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Code  
     Text  
     Description  
  
 
 
  
     1000  
     Invalid request!  Invalid username/email address or password.  Invalid OData query options.  
     Generic  
  
  
     1001  
    <code>NameAlreadyUsed</code> The name [CustomNameYouAdded] is already used.  
     An error message that is thrown if you try to create or edit a resource with a name that already exists in the database.  This error is returned for the following endpoints: 
      
         POST and PUT - <code>/odata/Assets</code> 
         POST and PUT - <code>/odata/QueueDefinitions</code> 
         POST - <code>/odata/QueueItems(id)/UiPathODataSvc.SetTransactionProgress</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.SetItemReviewStatus</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.DeleteBulk</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.SetItemReviewer</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.UnsetItemReviewer</code> 
         POST - <code>/odata/Queues(id)/UiPathODataSvc.SetTransactionResult</code> 
         POST - <code>/odata/Queues/UiPathODataSvc.AddQueueItem</code> 
         POST - <code>/odata/Queues/UiPathODataSvc.StartTransaction</code> 
         POST, PUT, and PATCH - <code>/odata/Releases</code> 
         POST, PUT, and PATCH - <code>/odata/Machines</code> 
         POST and PUT - <code>/odata/Robots</code> 
         POST - <code>/odata/Robots/UiPath.Server.Configuration.OData.ConvertToFloating</code> 
         POST and PUT - <code>/odata/ProcessSchedules</code> 
         POST - <code>/odata/Roles</code> 
         POST - <code>/odata/Users</code> 
      

  
  
     1002  
    <code>ItemNotFound</code> Robot does not exist.  
     An error message that is thrown if you make a request to a resource that does not exist in the database. It is returned for tenants, assets, jobs, host licenses, queues and queue items, processes, settings, and users.  
  
  
     1003  
    <code>StringProtectFailed</code> Protect call failed for provided string.  
   
      
         POST and PUT - <code>/odata/Robots</code> 
         PUT - <code>/odata/Settings('id')</code> 
         POST - <code>/odata/Settings/UiPath.Server.Configuration.OData.UpdateBulk</code> 
      

  
  
     1004  
    <code>ItemAlreadyExists</code> 
     This message is thrown if you try to create an asset or Robot that already exists in the database. This also applies to uploading a package.  
  
  
     1006  
    <code>ErrorInserting</code> 
   
      
         PUT - <code>/odata/Environments</code> 
         PUT - <code>/odata/QueueDefinitions</code> 
         POST - <code>/odata/QueueItems(Id)/UiPathODataSvc.SetTransactionProgress</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.SetItemReviewStatus</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.DeleteBulk</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.SetItemReviewer</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.UnsetItemReviewer</code> 
         POST - <code>/odata/Queues(id)/UiPathODataSvc.SetTransactionResult</code> 
         POST, PUT, and PATCH - <code>/odata/Machines</code> 
         POST and PUT - <code>/odata/Robots</code> 
         POST - <code>/odata/Robots/UiPath.Server.Configuration.OData.ConvertToFloating</code> 
         PUT - <code>/odata/ProcessSchedules(id)</code> 
         POST - <code>/odata/ProcessSchedules/UiPath.Server.Configuration.OData.SetEnabled</code> 
      

  
  
     1007  
    <code>ErrorUpdating</code> 
    This error is displayed if you try to update a transaction comment that was added by a different user, by making a PUT request to the <code>/odata/QueueItemComments(Id)</code> endpoint. 
  
  
     1008  
    <code>ErrorSendingEmail</code> 
    An error thrown if Orchestrator failed to send an email to a user when performing a POST, PUT, or PATCH request to the <code>/odata/Users</code> endpoint. 
  
  
     1009  
    <code>InvalidArgument</code> Invalid argument [ArgumentName].  
    &nbsp; 
  
  
     1010  
    <code>SqlAcquireLockFailure</code> 
    &nbsp; 
  
  
     1011  
    <code>LibrariesFeedInUse</code> Cannot open libraries feed. Try again later.  
     This message is displayed if the libraries feed cannot be accessed, due to various reasons.  The error can be returned by the following endpoints: 
      
         GET - <code>/odata/Libraries</code> 
         GET - <code>/odata/Libraries/UiPath.Server.Configuration.OData.GetVersions(packageId='Id')</code> 
         DELETE - <code>/odata/Libraries('Id')</code> 
         GET - <code>/odata/Libraries/UiPath.Server.Configuration.OData.DownloadPackage(key='key')</code> 
         POST - <code>/odata/Libraries/UiPath.Server.Configuration.OData.UploadPackage</code> 
      

  
  
     1012  
    <code>HasDependentItems</code> 
    This error is thrown if the organization unit you are trying to delete has users associated to it. This is an error displayed when making a DELETE call to the <code>/odata/OrganizationUnits</code> endpoint. 
  
  
     1013  
    <code>ItemIsInUse</code> Package is referred in active processes and cannot be deleted.  
     An error displayed when trying to delete a package version that is active, such as a DELETE request to https:/uipath.platform.com/odata/Processes('input_output_test%3A1.1.0'). Only inactive packages (not associated with an environment) can be removed.  
  
  
     1014  
    <code>ParameterMissing</code> Parameter [ParameterName] is missing.  
     This is a generic error that is thrown when a required parameter was not provided.  This error can be displayed for the following endpoints: 
      
         POST - <code>/odata/Alerts/UiPath.Server.Configuration.OData.RaiseProcessAlert</code> 
         POST - <code>/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs</code> 
         POST - <code>/odata/Jobs(Id)/UiPath.Server.Configuration.OData.StopJob</code> 
         POST - <code>/odata/Jobs/UiPath.Server.Configuration.OData.StopJobs</code> 
         POST - <code>/odata/Processes/UiPath.Server.Configuration.OData.SetArguments</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.SetItemReviewer</code> 
         POST - <code>/odata/QueueItems/UiPathODataSvc.UnsetItemReviewer</code> 
         POST - <code>/odata/Queues/UiPathODataSvc.StartTransaction</code> 
         POST - <code>/odata/Machines/UiPath.Server.Configuration.OData.DeleteBulk</code> 
         POST - <code>/odata/Robots/UiPath.Server.Configuration.OData.DeleteBulk</code> 
         POST - <code>/odata/Robots/UiPath.Server.Configuration.OData.ConvertToFloating</code> 
      

  
  
     1015  
    <code>ParameterInvalid</code> Parameter [ParameterName] is invalid. <code>Value should be between 0 and 168.</code> 
     This error is displayed in the following scenarios: 
      
         If you provide an invalid value for the Run Disconnected Hours setting, while making a PUT request to the <code>/odata/Settings('AttendedRobot.RunDisconnectedHours')</code> endpoint. 
         Throw new BadRequestException( ErrorCode .ParameterInvalid, nameof(Resource.DeepPaginationNotPossibleInElasticsearch), null, DefaultElasticMaxResultWindow); 
      

  
  
     1016  
    <code>DuplicateReference</code> Error creating [ReferenceName]. Duplicate Reference. ( Example : Error creating UiPath.Core.Model.Queues.UiQueueItem. Duplicate Reference.)  
     This error is displayed if you tried to add a queue item with a reference that already exists. This occurs only if you set your queue to work only with unique references.  
  
  
     1017  
    <code>ForbiddenOperation</code> Downloading the specified package is not allowed.  Terms and Conditions must be accepted.  
    A message displayed if the user you are authenticated with does not have rights to download a specific package or library, by performing GET requests to the <code>/odata/Processes/UiPath.Server.Configuration.OData.DownloadPackage(key='key')</code> or `/odata/Libraries/UiPath.Server.Configuration.OData.DownloadPackage(key='&#123;key 
  
  
     1018  
    <code>InvalidUser</code> Cannot connect to AD domain.  User does not exist.  
     This error message is displayed when you are trying to import and AD user which is not a member of the specified domain.  
  
  
     1050  
    <code>InvalidAuditRelationship</code> Cannot include specified relationship.  
     Audit  
  
  
     1100  
    <code>InvalidOrganizationUnit</code> The user is no longer associated with the organization unit.  
     Only displayed if organization units are enabled.  This error is displayed if you are trying to make calls using a user that is associated to a different organization unit than the one you are trying to access.  
  
  
     1101  
    <code>RequiredOrganizationUnit</code><code>An organization unit is required for this action.</code> 
     Only displayed if organization units are enabled on your Orchestrator instance.  The error is thrown when making POST requests endpoint without including an organization unit as a parameter.  
  
  
     1102  
    <code>OrganizationUnitNotEditable</code> The organization unit doesn't exist or is no longer associated with the user.  
     Only displayed if organization units are enabled.  This error message is thrown when making a POST request to the <code>/odata/Users(Id)/UiPath.Server.Configuration.OData.ToggleOrganizationUnit</code> endpoint if the user you are authenticated with is not associated with the organization unit provided as a parameter or does not exist. 
  
  
     1200  
    <code>MachineAlreadyPairedWithDifferentLicenseKey</code> There is already a robot on this machine with a different license key.  
     This error message is displayed if a Robot is already present on the specified machine with a different license key. It is thrown for the following endpoints: 
      
         POST, PUT, and PATCH - <code>/odata/Machines/</code> 
         POST and PUT - <code>odata/Robots/</code> 
         POST - <code>/odata/Robots/UiPath.Server.Configuration.OData.ConvertToFloating</code> 
         PUT - <code>/odata/Settings('id')</code> 
         POST - <code>/odata/Settings/UiPath.Server.Configuration.OData.UpdateBulk</code> 
      

  
  
     1201  
    <code>NoAvailableLicenses</code> 
     This error message is thrown if there are no more licenses on Orchestrator for the Robot you are trying to start a job on.  
  
  
     1202  
    <code>HasAttachedRobots</code> The machine [MachineName] cannot be deleted because it has robots attached to it.  
     This error message is thrown if you are trying to delete a machine that has Robots defined on it.  
  
  
     1203  
    <code>InvalidLicenseKey</code> Invalid license key.  The machine key is linked to another machine!  
     Robots  
  
  
     1204  
    <code>MachineNameRequired</code> 
     Robots  
  
  
     1205  
    <code>UserNameRequired</code> Username is required if the password is set.  
    &nbsp; 
  
  
     1206  
    <code>CannotDeleteBusyRobot</code> Busy robots cannot be modified or deleted.  
     This message is displayed if you are trying to delete a Robot that is currently executing a job.  
  
  
     1207  
    <code>MachineNameCannotChange</code> 
     Robots  
  
  
     1208  
    <code>MachineLicenseCannotChange</code> ; <code>InvalidNonProductionMachineSlots</code> ; <code>InvalidUnattendedMachineSlots</code> . 
     Robots  
  
  
     1209  
    <code>CannotUpdateBusyRobot</code> Cannot update the Username, Machine or Type of a busy Robot!  
     This message is displayed if you are trying to update a Robot that is currently executing a job.  
  
  
     1222  
    <code>RobotStatusNotification</code> 
     This is an alert that is triggered when a Robot disconnects from Orchestrator.  
  
  
     1223  
    <code>RobotStatusNotification</code> 
     This is an alert that is triggered when a Robot connected to Orchestrator becomes unresponsive.  
  
  
     1250  
    <code>EnvironmentDeploymentConflict</code> 
     This error message is thrown in the following cases: 
      
         If the package you are trying to associate with an environment is already deployed to a process. 
         If the Robot you are trying to associate with an environment is already deployed to a different environment. 
      

  
  
     1300  
    <code>ServerConflict</code> 
     Conflict (409)  
  
  
     1301  
    <code>ActionAlreadyPerformed</code> 
     Conflict (409)  
  
  
     1302  
    <code>UnavailableResources</code> 
     Conflict (409)  
  
  
     1400  
    <code>UserIsDeleted</code> 
     Authorization, Users, Roles  
  
  
     1401  
    <code>UserIsLockedOut</code> 
     Authorization, Users, Roles  
  
  
     1403  
    <code>ChangePassword</code> Change Password  
     Authorization, Users, Roles  
  
  
     1404  
    <code>PasswordExpired</code> The password has expired.  
     This error message is displayed when the password you are trying to log in with has expired.  
  
  
     1405  
    <code>InvalidPassword</code> 
     Authorization, Users, Roles  
  
  
     1406  
    <code>CannotDeleteStaticRole</code> 
     This message is shown if you are trying to delete the Administrator role.  
  
  
     1407  
    <code>UserNotEditable</code> 
     The user you are currently authenticated with does not have the right to edit to the indicated user.  
  
  
     1408  
    <code>DomainUnreachable</code> 
     Authorization, Users, Roles  
  
  
     1409  
    <code>PasswordResetFailed</code> 
     This error message is displayed if the password reset procedure failed.  
  
  
     1410  
    <code>ConfirmEmailFailed</code> Email confirmation failed.  
    &nbsp; 
  
  
     1411  
    <code>CannotUsePreviousPassword</code> 
     This error is returned if you are trying to use an old password during the reset password procedure.  
  
  
     1412  
    <code>RoleIsNotEditable</code> 
     This message is displayed if you are trying to make changes to the Administrator role, which is not editable.  
  
  
     1413  
    <code>UserNotFoundInDomain</code> 
     This error is thrown if the domain user you are trying to provision to Orchestrator does not belong to the defined Active Directory.  
  
  
     1414  
    <code>CannotUpdateUsername</code> Cannot update the username!  
     Authorization, Users, Roles  
  
  
     1415  
    <code>InvalidLoginMethod</code> 
     Authorization, Users, Roles  
  
  
     1500  
    <code>CredentialAssetEmptyPasswordForNewUser</code> Credential asset cannot have an empty password for a new user.  
    &nbsp; 
  
  
     1501  
    <code>CredentialAssetEmptyPasswordForNewRobot</code> Credential asset cannot have an empty password for a new robot.  
     This message is displayed if, when creating a credential asset, you do not also provide a value for the password.  
  
  
     1502  
    <code>AssetTypeNonUpdatable</code> The asset type cannot be updated.  
     This error is thrown if you are trying to change the asset type through a PUT request.  
  
  
     1503  
    <code>AssetNotAvailableForRobot</code> The asset does not have a value associated with this robot.  
     This message is shown if you the request you made was for a PerRobot asset, but the provided Robot is not associated with the given asset.  
  
  
     1600  
    <code>InvalidCron</code> Invalid cron expression syntax.  
     The schedule you tried to add contains a Cron expression which is not valid.  
  
  
     1601  
    <code>ScheduleWillNeverRun</code> 
    &nbsp; 
  
  
     1650  
    <code>DownloadUnavailable</code> 
     Processes/Packages/Jobs  
  
  
     1651  
    <code>CannotConnectToPackagesRepository</code> Cannot connect to packages feed, the URL may be invalid.  
     Processes/Packages/Jobs  
  
  
     1652  
    <code>NotSupportedByExternalFeeds</code> Not supported by External Feeds.  
     Processes/Packages/Jobs  
  
  
     1653  
    <code>ErrorDownloading</code> 
     Processes/Packages/Jobs  
  
  
     1654  
    <code>InvalidPackageDetails</code> Invalid package details!  
     Processes/Packages/Jobs  
  
  
     1655  
    <code>TenantFeedInUse</code> Cannot open the package feed. Try again later.  
     Processes/Packages/Jobs  
  
  
     1656  
    <code>InvalidProcessKey</code> 
     Processes/Packages/Jobs  
  
  
     1657  
    <code>JobTypeCannotBeStopped</code> 
     Processes/Packages/Jobs  
  
  
     1658  
    <code>JobCannotBeCancelled</code> Cannot cancel a job with status [Status]. This can only be applied to Running, Pending or Stopping jobs.  
     This message is shown if you are trying to cancel a job that has one of the following statuses: Successful, Faulted, Terminating, Stopped.  
  
  
     1659  
    <code>JobCannotBeTerminated</code> Cannot terminate a job with status [Status]. This can only be applied to Running, Pending or Stopping jobs.  
     This error is displayed if you are trying to cancel a job that has one of the following statuses: Successful, Faulted, Stopped.  
  
  
     1660  
    <code>VersionNotFound</code> The job's package [PackageName], version [VersionNumber] could not be found.  
     This error is thrown if, when trying to start a job, the package with the indicated version cannot be found in the NuGet feed.  
  
  
     1661  
    <code>ProcessNotFound</code> , <code>PackageNotFound</code> .  The associated process no longer exists.  
     Processes/Packages/Jobs  
  
  
     1662  
    <code>HasAttachedProcesses</code> 
     Processes/Packages/Jobs  
  
  
     1663  
    <code>InvalidExtension</code> 
     Processes/Packages/Jobs  
  
  
     1664  
    <code>InvalidPackageCount</code> 
     Processes/Packages/Jobs  
  
  
     1665  
    <code>PreviousVersionNotFound</code> 
     Processes/Packages/Jobs  
  
  
     1666  
    <code>HasRunningJobs</code> 
     Processes/Packages/Jobs  
  
  
     1667  
    <code>TenantNotFound</code> Tenant not found.  
    &nbsp; 
  
  
     1670  
    <code>PendingJobsAlreadyExist</code> The robots already have pending jobs for this process.  
     This message is displayed when you already have a pending job on the same process and Robot.  
  
  
     1671  
    <code>InvalidStartJobRobotIds</code> The specified robot(s) id(s) are invalid.  
     Processes/Packages/Jobs  
  
  
     1672  
    <code>UnregisteredCannotStartJobs</code> Starting jobs is not possible. A valid license is required.  
     Processes/Packages/Jobs  
  
  
     1673  
    <code>LicenseExpiredCannotStartJobs</code> License expired, starting jobs is no longer possible.  
     Processes/Packages/Jobs  
  
  
     1674  
    <code>InvalidReleaseKey</code> Undefined process.  
     The id of the process on which you are trying to start a job is not valid.  
  
  
     1675  
    <code>InvalidPackageVersion</code> Invalid package version.  
     Processes/Packages/Jobs  
  
  
     1676  
    <code>TenantIsDisabled</code> Tenant [NameOfTenant] is disabled!  
     Processes/Packages/Jobs  
  
  
     1677  
     PackageNotFound  
    &nbsp; 
  
  
     1678  
    <code>BackgroundJobNotification</code> 
     This error is thrown if there are no available Robots for a schedule, and therefore no jobs can be created.  
  
  
     1679  
     PathTooLong  
    &nbsp; 
  
  
     1680  
    <code>JobStatusNotification</code> 
     This alert is generated when a job fails.  
  
  
     1700  
    <code>CyberArkEditPasswordNotAllowed</code> 
     Third-party components  
  
  
     1750  
    <code>LogMessageNotFound</code> 
     Logs  
  
  
     1800  
    <code>EncryptionKeyNotFound</code> 
     Configuration  
  
  
     1801  
    <code>EncryptionKeyIncorrectFormat</code> Configured encryption key is not in a valid Base64 format.  
     Configuration  
  
  
     1850  
    <code>TransactionReferenceRequired</code> 
     Queue/Queue item  
  
  
     1851  
    <code>InvalidTransactionProgressStatus</code> 
     The progress status of the transaction you are trying to update is not the correct one for the update you want to perform.  
  
  
     1852  
    <code>TransactionNotStarted</code> 
     Queue/Queue item  
  
  
     1853  
    <code>ReviewerNotAvailable</code> 
     The user you are trying to assign as a reviewer to a transaction does not have the required permission (View and Edit on transactions).  
  
  
     1855  
    <code>QueueDefinitionParametersCannotChange</code> 
     Queue/Queue item  
  
  
     1856  
    <code>QueueTransactionStatusNotification</code> 
     This message error is displayed if an application is thrown for an item and it is not going to be retried anymore.  
  
  
     1900  
    <code>LicenseNotFound</code> License not found.  
     License  
  
  
     1901  
    <code>LicenseExpired</code> License expired!  
     License  
  
  
     1902  
    <code>LicenseAlreadyInUse</code> The license is already in use!  
     License  
  
  
     1903  
    <code>InvalidLicenseFormat</code> Invalid license format.  
     License  
  
  
     1904  
    <code>LicenseLimitExceeded</code> 
     License  
  
  
     1905  
    <code>UnattendedLicenseLimitExceeded</code> 
     License  
  
  
     1906  
    <code>NonProductionLicenseLimitExceeded</code> 
     License  
  
  
     1907  
    <code>AttendedLicenseLimitExceeded</code> 
     License  
  
  
     1908  
    <code>DevelopmentLicenseLimitExceeded</code> 
     License  
  
  
     1909  
    <code>RobotFailedToAcquireLicense</code> 
     License  
  
  
     1910  
    <code>NonProductionSlotsLimitExceeded</code> 
     License  
  
  
     1911  
    <code>UnattendedSlotsLimitExceeded</code> 
     License  
  
  
     1912  
    <code>LicenseUnregistered</code> 
     License  
  
  
     1913  
    <code>LicenseNotAvailable</code> 
     License  
  
  
     1914  
    <code>NotEnoughAvailableSlots</code> Robot Licensing Failed. There are no available licenses on the server.  
     This error message is displayed in the Job Details if you tried to execute a job on a machine that is not licensed, the job has the state Pending, a robot assigned.  
  
  
     1915  
    <code>NotEnoughRuntimeLicenses</code> Robot Licensing Failed. There are no available licenses on the server.  
    
  
  
     1916  
    <code>SlotsExceedLicenseLimit</code> No available licenses: the number of new machine slots would exceed the total license count.  
     License  
  
  
     1917  
    <code>NotEnoughAvailableLicenses</code> There are not enough &#123;0  
     License  
  
  
     1918  
    <code>HostLicenseLimitExceeded</code> 
     License  
  
  
     1919  
    <code>NoHostLicense</code> 
     License  
  
  
     1920  
    <code>LicenseNewInvalidArguments</code> 
     License