Error Codes

The XML API and SOAP API return error codes to indicate problems with your request or specific to a query or action on a particular object. The following tables list the error codes, the commands or methods and the type of objects that can result in the error, and the error descriptions.

0 – 199 | 200 – 399 | 400 – 599 | 600 – 799 | 800 – 899 | 900 – 999 | 1000 – 1199 | 1200 – 1999 | 2000 – 2999

0 – 199

Error Code	Command	Object Type	Short Message	More Information
0	—	—	Success	The operation completed successfully.
1	—	—	Unknown Error	An unknown error occurred. Try again and if the problem persists, contact OpenAir Customer Support.
2	—	—	not logged in	The operation requires authentication but the authentication command was not successful or was omitted in the API request.
3	—	—	too many arguments	The API request included too many arguments for one of the commands. Verify the commands and the arguments for each command included in your request.
4	—	—	too few arguments	The API request did not include enough arguments for one of the commands. Verify the commands and the arguments for each command included in your request.
5	—	—	Unknown Command	One of the commands in your API request uses an unknown method. Verify the commands and ensure only supported methods are used in your request.
6	—	—	Access from an invalid URL	The URL used to access the API is not valid. Verify the URL.
7	—	—	Invalid OffLine version	The version of OpenAir OffLine is not supported. Install the latest version of the OpenAir OffLine add-on on your computer.
8	—	—	Failure + Dynamic Message	The operation was unsuccessful. Review the Error record included in the response. This code is reserved for dynamically generated error codes.
9	—	—	Logged out	The sessionId (session-based authentication) or accessToken (OAuth 2.0 access token authorization) is not valid or has expired. Use the login method to obtain a sessionId if using session-based authentication. Refresh the OAuth2.0 access token, if using OAuth 2.0 access token authorization.
10	—	—	Invalid parameters	Invalid parameters used. Verify your API request.

200 – 399

Error Code	Command	Object Type	Short Message	More Information
201	CreateUser createUser()	User	invalid company	The account with the Company ID [nickname] specified does not exist.
202	CreateUser createUser()	User	duplicate user nick	There is already a user with the same User ID [nickname]. Use a different value.
203	CreateUser createUser()	User	too few arguments	Both a company object and a user object must be specified.
204	CreateUser createUser()	User	Namespace error	Users must be created in the same namespace as the company.
205	CreateUser createUser()	User	Workschedule error	Invalid account workschedule specified
206	CreateUser createUser()	User	Role error	Invalid role specified
303	CreateUser createUser()	User	please pick a different password	The password specified does not meet the minimum password policy requirements configured for the OpenAir account. Review the password policy and use a password that meets the policy requirements.
304	CreateAccount	—	Not enabled	Reserved usage. The CreateAccount method is not available to OpenAir customers.
305	CreateUser createUser()	User	Not enabled to edit password	The password cannot be modified or the user is set up to use SAML single sign-on for authentication.

400 – 599

Error Code	Command	Object Type	Short Message	More Information
401	Authentication	—	Auth failed	Access denied. The combination of company ID [company], user ID [user] and password [password] specified is not valid. This is a generic error message used for all authentication issues other than those specified in this table.
409	Authentication	—	Account Canceled	The account with company ID company was canceled and cannot be accessed.
411	Authentication	—	Account conflict, contact customer service	There is a problem with the account. Contact OpenAir Customer Support.
413	Authentication	—	Account not privileged to access API	API access is not permitted for this OpenAir account or user.
414	Authentication	—	Temporarily unavailable	The service is temporarily unavailable. Try again in a few minutes and if the problem persists, contact OpenAir Customer Support.
415	Authentication	—	Account archived	The account with company ID company was archived and cannot be accessed.
417	Authentication	—	Restricted IP address	Access is not allowed from the client IP address. The IP address is not in the IP address allowlist for the authenticating or authenticated user. See IP Restriction.
418	Authentication	—	Invalid uid session	The uid specified is not valid. Repeat authentication.
419	Authentication	—	Authentication failed, please retry	Unexpected authentication failure. Try again later. If you are using session-based authentication or OAuth2.0 access token authorization, renew the sessionId or accessToken.
420	—	—	Authentication failed	SAML single sign-on authentication error. If the problem persists, contact the identity provider services vendor.
421	—	—	Account misconfiguration or invalid assertion	SAML single sign-on authentication error. Verify your identity provider configuration and the SAML integration configuration in OpenAir. If the problem persists, contact the identity provider services vendor.
423	—	—	No permissions to read ServerStatus data	Reserved usage. Server status information is not accessible to OpenAir customers.
424	Add, Modify, Delete add(), modify(), delete()	— Envelope Timesheet	No permissions to modify data	The authenticated user is not an account administrator or the owner of the object and the account is configured to prevent the creation, modification or deletion of an object owned by a different user.
425	Add, Modify, Delete add(), modify(), delete()	—	Functionality not available	The functionality is not available for your OpenAir account. For example, the API returns this error if you attempt to modify proxy user information and your account is not configured to allow proxy modification using the API, or if you attempt to add or modify project task estimate objects and the Hours Remaining on Tasks feature is not enabled for your account.
426	Authentication	—	You must use account-specific domain	All connections to your OpenAir account must use the account-specific domain <account-domain>. Use the following URLs for API requests. For more information, see Getting Started with the XML API and SOAP API. XML API — https://<account-domain>/api.pl SOAP API — https://<account-domain>/soap
501	—	—	API authentication required	API access must first be authenticated.
503	—	—	Invalid or missing key attribute	A valid API key must be specified.
504	—	—	Invalid or missing namespace attribute	A valid API namespace must be specified.
505	—	—	The namespace and key do not match	The API namespace and API key combination is not valid.
506	—	—	Authentication key disabled	This API key is disabled. For more information, contact OpenAir Customer Support
555	—	—	You have exceeded the limit set for the account for input objects	The maximum number of object you can add or modify in a single request is 1,000. Above this number object must be processed in batches.
556	—	—	API rate limit exceeded	The maximum number of requests allowed for your OpenAir account in a 24-hour window or in a 60-seconds window has been reached. Try again later.

600 – 799

Error Code	Command	Object Type	Short Message	More Information
601	Add, CreateUser, Read, Modify, ModifyOnCondition, Delete, Submit, Approve, Reject, Unapprove add(), createUser(), read(), modify(), upsert(), delete(), submit(), approve(), reject(), unapprove()	All	Invalid id/code	Could not find an object matching the internal ID or the criteria specified in your request.
602	Read read()	All	Invalid field	One or more of the property names listed for inclusion in the response are not valid. Verify the fields listed in your API request.
603	Read read()	All	Invalid type or method	Either the object type or the read method specified is not valid.
604	Add add()	Attachment	Attachment size exceeds space available	The OpenAir account does not have enough storage space available to add the attachment. Contact your account administrator to increase the storage space for your account or free some of the account storage space.
605	Read read()	All	Limit clause must be specified and be less than the account limit for output data	The maximum number of object you can read in a single request is 1,000. Use the limit attribute to process objects in batches.
606	Read read()	RevenueProjection	Projections are running, please try again in a few minutes	Revenue projection objects can only be read using the API if there are no charge projection runs in progress. This is because the data may be incomplete until the charge projection job completes.
701	Delete delete()	All	Cannot delete, failed dependency check	All dependencies (objects of the same or other types directly or indirectly referencing this object by internal ID) must be deleted before this object can be deleted.
702	Delete delete()	Preference	Invalid note	The preference could not be deleted.

800 – 899

Error Code	Command	Object Type	Short Message	More Information
800	CreateUser, Modify createUser(), modify()	User	Synchronization failed	Failed to propagate the changes to the identity service. Please try again later.
801	Add, Modify add(), modify()	Agreement Booking Contact Customerpo Invoice Issue Payment Project ProjectBudgetGroup ResourceRequest	Not a valid Customer ID	The customer with internal ID customerid does not exist or is marked as deleted. Verify the customer internal ID.
802	Add, Modify add(), modify()	Envelope	This Envelope number is already taken	An expense report with tracking number number already exists. Use a different tracking number, or do not specify a tracking number to use auto-numbering.
803	Add, CreateUser, Modify add(), createUser(), modify()	Company HierarchyNode User	This user does not have permission to modify the record	The authenticated user must be an account administrator or have sufficient role and access permissions to modify this record.
804	Add, Modify add(), modify()	Item	Not a valid Item type	The expense item type must be either R (regular) or M (mileage).
805	Add, Modify add(), modify()	Ticket ResourceRequest ResourceRequestQueue	Reference number in use	A receipt with tracking number reference_number already exists within the associated expense report. Use a different tracking number. A resource request (queue) with tracking number number already exists. Use a different tracking number.
806	Add, Modify add(), modify()	Ticket Task	Already accepted by signer	The receipt or time entry was accepted by a signer and cannot be modified.
807	Add, Modify add(), modify()	—	Invalid payment type	The payment type passed is not valid (possibly inactive, or deleted).
808	Add, Modify add(), modify()	Preference	Invalid preference	To modify a preference you must set a valid name and group_name.
809	Add, Modify add(), modify()	Task	Invalid Timesheet	The timesheet with internal ID timesheetid does not exist or is marked as deleted. Verify the timesheet internal ID.
810	Add, Modify add(), modify()	Projecttask Projecttaskassign	Invalid index	The index you specified does not exist in that table.
811	Add, Modify add(), modify()	Projecttask	Invalid predecessor	One or more internal IDs in the predecessors list could not be found.
812	Add, Modify add(), modify()	Projecttask	Invalid parentid	The internal ID of the immediate ancestor [parentid] is not valid. Verify the internal ID for the immediate ancestor.
813	Add, Modify add(), modify()	Agreement_to_project Booking Customerpo_to_project ExpensePolicy Issue Projectassign ProjectAssignmentProfile ProjectBudgetGroup ProjectPricing Projecttask Projecttaskassign Purchase_item Ticket ResourceRequest ResourceRequestQueue	Invalid projectid	The project with internal ID projectid does not exist or is marked as deleted. Verify the project internal ID.
814	Add, Modify add(), modify()	Projecttask	duplicate id_number	This user-defined task number id_number is already used for another task in the same project.
815	Add, Modify add(), modify()	Booking Issue Projecttaskassign ProjecttaskEstimate	Projecttask does not exist	The project task with internal ID project_taskid does not exist or is marked as deleted. Verify the project task internal ID.
816	Add, CreateUser, Modify add(), createUser(), modify()	Proxy User	User role/type does not exist	The role_id or type is not valid.
817	Add, Modify add(), modify()	Ticket Reimbursement	Invalid envelope	The expense report with internal ID envelopeid does not exist or is marked as deleted. Verify the expense report internal ID.
818	CreateUser, Modify createUser(), modify()	User	duplicate user nick	A user with the same nickname already exists. Use a different value for nickname.
819	Add, Modify add(), modify()	Slip	Slip cannot be deleted	This slip cannot be deleted because it is part of an invoice.
820	Add, Modify add(), modify()	Attachment Envelope Ticket Reimbursement	Envelope not open	The expense report cannot be modified because it is has been submitted for approval (no longer open).
821	Add, Modify add(), modify()	Attachment ProjecttaskEstimate Task Timesheet	Timesheet not open	This error is returned under the following conditions: The timesheet cannot be modified because it has been submitted for approval. The timesheet status is A (Approved) or X (Archived) and the account configuration does not allow the modification of approved and archived timesheets using the API. The timesheet is not in an open period and the authenticated user's role does not allow the modification of timesheets outside of open periods. The timesheet status is S (Submitted), the authenticated user is the submitter, and the account configuration does not allow the modification of submitted timesheet by the timesheet owner The timesheet has been exported and the account configuration does not allow the modification of exported timesheets. The authenticated user is neither the timesheet owner nor an account administrator.
822	Add, Modify add(), modify()	Slip	Slip cannot be modified	The charge cannot be edited.
823	Add, Modify add(), modify()	Slip	Slip, bad invoice id	The charge is already part of an invoice and cannot be moved to a different invoice.
824	Add, Modify add(), modify()	Customer	Must specify name or company	The customer or prospect must have a valid name or company value.
825	Add, Modify add(), modify()	Slip Invoice Payment	Invalid invoice	The invoice with internal ID invoiceid or original_invoiceid does not exist. Verify the invoice internal ID.
826	Add, Modify add(), modify()	Actualcost Agreement Customerpo Envelope Fulfillment ImportExport Payment Ticket Reimbursement	Date is required	A date must be specified, or in the case of the ImportExport object, either a last_import or last_export daet must be specified.
827	Add, Modify add(), modify()	Reimbursement	Reimbursements can only be applied after the envelope is approved	The status of the expense report with internal ID envelopeid must be A (Appoved).
828	Add, Modify add(), modify()	Invoice	This Invoice number is already taken	This user-defined invoice number number is already used for another invoice. Use a different value or do not specify a number to use auto-numbering.
829	Add, CreateUser, Modify add(), createUser(), modify()	Actualcost Booking Entitytag Issue Leave_accrual_rule_to_user Leave_accrual_transaction LoadedCost Projectassign Projecttaskassign Proxy ResourceAttachment Resourceprofile ResourceRequest Revenue_recognition_rule TargetUtilization Task Timesheet User	Not a valid user	The user with internal ID userid, ownerid, assigned_user, proxy_id or line_manager_id does not exist, is marked as deleted or is not an active user. In some cases Verify the user internal ID.
830	Add, Modify add(), modify()	Booking ResourceRequest	Not a valid booking type	booking_type_id is required and must be a valid booking type internal ID.
831	Add, Modify add(), modify()	AccountingPeriod Booking Entitytag Leave_accrual_rule_to_user Leave_accrual_transaction Project ResourceRequest ResourceRequestQueue Timesheet UserWorkschedule	No startdate or enddate specified	A start date and an end date are both required.
832	Add, Modify add(), modify()	AccountingPeriod Booking Entitytag ResourceRequest ResourceRequestQueue Timesheet	Illegal date range	The start date must be before the end date.
833	Add, Modify add(), modify()	Booking	Percentage not specified	A percentage must be specified if as_percentage is set.
834	Add, Modify add(), modify()	Booking	Hours not specified	hours must be specified if as_percentage is not set.
835	Add, Modify add(), modify()	Project	Only owner can edit this project	The authenticated user must be the project's owner to modify this project or project task.
836	Add, Modify add(), modify()	Project Schedulerequest	Not allowed to add entity	The authenticated user does not have sufficient permission to add a record.
837	Add, CreateUser, Modify add(), createUser(), modify()	All objects with currency property	Not a valid account currency	The currency must be a valid currency for the account as set in Administration > Account > Currencies > Multi-currency
838	Add, Modify add(), modify()	LoadedCost	Not allowed to have more than one current costs per user	Only one loaded cost can be the current loaded cost for the same user.
839	Add, Modify add(), modify()	Attachment	base64_data must be set to add an attachment	The base 64 encoded binary data of the attachment file [base64_data] must be set.
840	CreateUser, Modify createUser(), modify()	User	Not a valid primary filter set	A valid primary filter set [primary_filter_set] must be specified.
841	CreateUser, Modify createUser(), modify()	User	Invalid email	email must be specified.
842	Add, Modify add(), modify()	—	Invalid period	Period is a required field.
843	Add, Modify add(), modify()	—	Invalid timing	Timing is a required field.
844	Add, Modify add(), modify()	Leave_accrual_rule_to_user Leave_accrual_transaction	Invalid leave accrual rule	A leave_accrual_ruleid must be specified.
845	Add, Modify add(), modify()	Leave_accrual_transaction	Invalid task	A taskid must be specified.
846	Add, Modify add(), modify()	Purchase_item	Cannot create non-po purchase items	The Quick PO functionality must be enabled for your OpenAir account and you must have sufficient permission to add or modify a "quick PO" or "non-po purchase item".
847	Add, Modify add(), modify()	Purchase_item	Purhaseorderid must be blank	purchaseorderid must be empty to add or modify a "quick PO" or "non-po purchase item".
848	Add, Modify add(), modify()	Purchase_item	Only non_po purchase items can be added/modified	non_po must be set to 1 to add or modify a "quick PO" or "non-po purchase item".
849	Add, Modify add(), modify()	Entitytag Envelope Timesheet	Another record with the same date range already exists	The period between start and end dates overlap with that of another record, and period overlaps are not allowed. Verify the start_date and end_date.
850	Add, Modify add(), modify()	Entitytag	Another record already exists as a default for this user and group	There is already one default entity tag record associated with the user with internal ID userid and the entity tag group with internal ID tag_group_id, and only one default entity tag record is allowed.
851	Add, Modify add(), modify()	Entitytag	Not a valid tag_group_attribute	The tag group attribute with internal ID tag_group_attributeid is not valid.
852	Add, Modify add(), modify()	Contact Customer	Duplicate external_id	Another record with the same external_id already exists.
853	Add, Modify add(), modify()	LoadedCost	Invalid Loaded Cost parameters	When current is set to 1, start and end dates must be empty, and inversely if start and end dates are set, current must be set to 0.
854	Read read()	All object types	Too many records requested	— The number of records requested is larger than the maximum allowed. Limit the data returned using filter parameters.
856	Add, Modify add(), modify()	AccountingPeriod Leave_accrual_rule_to_user	Date overlaps with existing record	The period between start and end dates overlap with that of another record. Verify the start_date and end_date.
857	Add, Modify add(), modify()	Booking Entitytag ForexInput	Date range exceeded maximum	The period between start and end dates exceeds the maximum length allowed.
858	Add, Modify add(), modify()	ForexInput	ForexInput error	Update error. Record could not be saved.
859	Add, Modify add(), modify()	ExpensePolicy Ticket	Invalid customer id	The customer with internal ID customerid does not exist or is marked as deleted. Verify the customer internal ID.
860	Add, Modify add(), modify()	Entitytag	default_for_entity and start and end dates are mutually exclusive	Male sure either default_for_entity or start and end dates are set but not both.
861	Add, Modify add(), modify()	Slip	Invalid customer id	The customerid on the charge must be the same as the internal ID of the customer associated with the invoice this charge is part of (invoice with internal ID invoiceid).
862	Add, Modify add(), modify()	Slip	Invalid project id	The customer associated with the project with internal ID projectid must be the same as the customer associated with the invoice this charge is part of (invoice with internal ID invoiceid).
863	Add, Modify add(), modify()	Slip	Only one project per invoice	The invoice this charge is part of (invoice with internal ID invoiceid) is associated with a different project and the account is configured to allow only one project per invoice.
864	Add, CreateUser, Modify add(), createUser(), modify()	User UserWorkschedule	Error while saving user workschedule	Error saving the user workschedule. Record could not be saved.
865	CreateUser, Modify createUser(), modify()	User	Invalid workdays	Workdays must be a comma-separated list of values, containing digits between 0 (Monday) and 6 (Sunday).
866	Add, CreateUser, Modify add(), createUser(), modify()	User UserWorkschedule	Invalid workdays or workshours	Both workdays and workhours must be set with valid values when setting a user work schedule.
867	CreateUser, Modify createUser(), modify()	User	Distinct workhours not enabled	workhours must include only one value and not a comma-separated list of values if your account configuration does not allow for different work hours per day.
868	Add, Modify add(), modify()	Hierarchy	Invalid type specified	The hierarchy must be associated with a record type. The record type can be either customer, project, or user.
869	Add, Modify add(), modify()	Hierarchy	Invalid value for primary_user_filter	primary_user_filterset can be set to 1 only for one hierarchy and only if type is set to project.
870	Add, Modify add(), modify()	Hierarchy	Invalid value for primary_dropdown_filter	primary_dropdown_filter can be set to 1 only for one hierarchy and only if type is set to project.
871	Read read()	—	Invalid number of read arguments supplied	[Read error] — The number of argument objects must be equal to the number of filter clauses.
872	Add, Modify add(), modify()	Actualcost	Invalid cost type	The cost type with internal ID cost_typeid does not exist or is marked as deleted. Verify the cost type internal ID.
873	Add, Modify add(), modify()	Actualcost	Invalid period	A period must be specified.
874	Add, Modify add(), modify()	Schedulerequest	Schedule request error	Error saving the record. Record could not be saved.
875	Add, Modify add(), modify()	Repeat	Repeat error	Error saving the record. Record could not be saved.
876	Add, Modify add(), modify()	Attachment	Attachment too small	Attachment size is too small. Returned when attempting to save an empty backup file for OpenAir Integration Manager.
877	Add, Modify add(), modify()	—	Invalid project group	The project assignment group with internal ID project_groupid does not exist or is marked as deleted. Verify the project assignment group internal ID.
878	Add, Modify add(), modify()	—	Purchaseorder not open	The purchase order cannot be modified because it is no longer open.
879	Add, Modify add(), modify()	Fulfillment	Invalid purchase order	The purchase order with internal ID purchaseorder_id does not exist or is marked as deleted. Verify the purchase order internal ID.
880	Add, Modify add(), modify()	Purchase_item	Invalid purchase item	Quick POs or"non-PO" purchase items must have a positive quantity.
881	Add, Modify add(), modify()	Attachment	Invalid attachment	The immediate ancestor attachment with internal ID parentid does not exist or is not in workspace with internal ID workspaceid.
882	Add, Modify add(), modify()	Slip	Invalid reference slip ID	The original charge with internal ID ref_slipid associated with this credit or rebill charge does not exist or is marked as deleted. Verify the original charge internal ID.
883	Add, Modify add(), modify()	Slip Project Revenue_recognition_transaction	Invalid portfolio project ID	The project with internal ID portfolio_projectid does not exist, is marked as deleted, is not associated with the same customers as this record, or is not a portfolio a project. Verify the portfolio project internal ID.
884	Add, Modify add(), modify()	Project	Invalid portfolio link	A portfolio project cannot be subordinated to another portfolio project. portfolio_projectid cannot be set if is_portfolio_project is set to 1.
885	Add, Modify add(), modify()	Purchase_item	Invalid purchase item	The date must be specified.
886	Add, Modify add(), modify()	Ticket	Project task type mismatch	The project task type with internal ID project_task_typeid does not exist or is marked as deleted, or project_taskid is not specified.
887	Add, Modify add(), modify()	ProjectAssignmentProfile	Wrong project assignment profile name	A project assignment profile with the same name and associated with the same project already exists.
888	Add, Modify add(), modify()	Task	Timesheet task invalid date	The time entry date is not within the project task assignment date range. Requirement set a the project task level when the Time Entries Match Task Assignments feature is in use.
889	Add, Modify add(), modify()	Attachment	Ticket cannot be modified	The receipt associated with this attachment cannot be edited.
890	Add, Modify add(), modify()	Attachment	User cannot be modified	The user associated with this attachment cannot be edited
891	Add, CreateUser, Modify add(), createUser(), modify()	Attachment NewsfeedMessage User	Invalid user	The associated user does not exist or is marked as deleted. Verify the user internal ID.
892	Add, Modify add(), modify()	Attachment	Invalid envelope	The associated expense report does not exist or is marked as deleted. Verify the expense report internal ID.
893	Add, Modify add(), modify()	Attachment	Invalid receipt	The associated receipt does not exist or is marked as deleted. Verify the receipt internal ID.
894	Add, Modify add(), modify()	Attachment ProjecttaskEstimate	Invalid timesheet	The associated timesheet does not exist or is marked as deleted. Verify the timesheet internal ID.
895	Add, Modify add(), modify()	Attachment	Invalid customerpo	The associated customer PO does not exist or is marked as deleted. Verify the customer PO internal ID.
896	Add, Modify add(), modify()	Attachment	Agreement cannot be modified	The agreement associated with this attachment cannot be edited.
897	Add, Modify add(), modify()	Attachment	Customerpo cannot be modified	The customer PO associated with this attachment cannot be edited.
898	Add, Modify add(), modify()	Attachment	Invalid workspace	The workspace with internal ID workspaceid does not exist or is marked as deleted. Verify the workspace internal ID.
899	Add, Modify add(), modify()	ExpensePolicyItem	Invalid expense policy	The expense policy with internal ID expense_policyid does not exist or is marked as deleted. Verify the expense policy internal ID.

900 – 999

Error Code	Command	Object Type	Short Message	More Information
900	Add, Modify add(), modify()	ExpensePolicyItem	Invalid item	The expense item with internal ID itemid does not exist or is marked as deleted. Verify the expense item internal ID.
901	MakeURL makeURL()	—	The combination of uid, app, arg, and page is not valid	[makeURL error] — The values passed don't combine to represent a valid page, check the values and try again
902	MakeURL makeURL()	—	A valid record could not be created from the arg passed	[makeURL error] — Check to make sure the required fields are being passed in the arg record
903	MakeURL makeURL()	—	The user does not have access to that page	[makeURL error] — That combination of app, arg, and page is not valid for this user
904	Add, Modify add(), modify()	Purchaseorder Schedulerequest	This number is already taken	The user-defined number [number] is already used for another record. Use a different value or do not specify a number to use auto-numbering.
905	Add, Modify add(), modify()	Purchase_item Schedulerequest_item	Invalid purchaseorder	The purchase order with internal ID purchaseorderid or the time off request with internal ID schedule_requestid does not exist or is marked as deleted. Verify the internal ID.
906	Add, CreateUser, Modify add(), createUser(), modify()	Category Item Project Projectbillingrule Projecttask Ticket Revenue_recognition_rule_amount Task Timetype User	Invalid Cost Center	The cost center with internal ID cost_centerid does not exist or is not an active cost center. Verify the internal ID.
907	Add, Modify add(), modify()	Contact	Invalid Contact	First name, Last name and email are required fields.
908	Add, Modify add(), modify()	Agreement Attachment Category Category_<N> CustomerLocation Customerpo Hierarchy Leave_accrual_rule Project Projectgroup Projecttask UserWorkschedule	Invalid Name	A name [name] must be specified.
909	Add, Modify add(), modify()	Customer Project	Invalid Contact	One of the associated contacts does not exist or is not associated with the customer. Verify all contact internal IDs.
910	Modify modify()	—	Lookup record not located	[Lookup error] — There is no record of the specified type matching one or more lookup field values.
911	Add, Modify add(), modify()	Task	No Timesheet specified	The internal ID of the associated timesheet [timesheetid] must be specified when modifying a time entry.
912	Add, Modify add(), modify()	Projectbillingrule	Invalid type specified	A valid type must be specified.
913	Add, Modify add(), modify()	Issue Projectassign Projecttaskassign	Invalid project task specified for a project	The project task with internal ID project_task_id must be part of the project with internal ID project_id (issue). A projectid must be specified (project assignment). A projecttaskid must be specified (project task assignment).
914	Add, Modify add(), modify()	Resourceprofile	Invalid resourceprofile_type_id specified	A valid resourceprofile_typeid must be specified.
915	Add, Modify add(), modify()	Resourceprofile	Invalid type specified	Both type and resourceprofile_typeid must be specified and type must have the same value as type for the resource profile type record with internal ID resourceprofile_typeid.
916	Modify modify()	—	Table specified does not have external_id field	[Lookup error] — Either the record type (table) does not exist or the lookup field does not exist for the record type.
917	Add, Modify add(), modify()	Issue	This Issue number is already taken	The user-defined number [number] is already used for another record. Use a different value or do not specify a number to use auto-numbering.
918	Add, Modify add(), modify()	Issue	No description specified	The issue must have a description.
919	Add, Modify add(), modify()	IssueStage	Only one default issue stage is permitted	There is already one issue stage record with default_for_new set to 1, and only one default issue stage is allowed.
920	Add, Modify add(), modify()	RateCardItem	No rate card ID specified	A rate_cardid must be specified.
921	Add, Modify add(), modify()	RateCardItem	Job code in use for rate card	There is already one rate card item with the same job_codeid in the associated rate card.
922	Add, Modify add(), modify()	RateCardItem	Invalid job code specified	The job code with internal ID job_codeid does not exist or is not an active job code. Verify the internal ID.
923	Add, Modify add(), modify()	RateCardItem	Invalid rate card specified	The rate card with internal ID rate_cardid does not exist or is not an active rate card. Verify the internal ID.
924	Add, Modify add(), modify()	RateCardItem	No job code ID specified	A job_codeid must be specified.
925	Add, Modify add(), modify()	Project	Invalid template project ID specified	The project with internal ID template_project_id does not exist or is marked as deleted. Verify the internal ID.
926	CreateUser, Modify add(), modify()	User	Invalid value for user cost	cost must be set to a positive value.
927	CreateUser, Modify createUser(), modify()	User	Invalid user cost start date	cost_start_date must not be before any existing historical cost start date for the user.
928	Add, Modify add(), modify()	Workspaceuser	Invalid project group ID for workspace user	The project assignment group with internal ID projectgroupid does not exist or is marked as deleted. Verify the internal ID.
929	Add, Modify add(), modify()	Workspaceuser	Workspace user cannot contain both project group ID and user ID	Either projectgroupid or userid can be set but not both.
930	CreateUser, Modify createUser(), modify()	User	Generic flag cannot be modified	is_generic cannot be modified. A generic resource cannot become a named resource and inversely.
931	Add, Modify add(), modify()	Projectassign	Duplicate project assignment	The user with internal ID userid is already assigned to the project with internal ID projectid.
932	Add, Modify add(), modify()	Proxy	Only admin users may update proxies	The authenticated user must be an account administrator to add, modify or delete proxy information.
933	Add, Modify add(), modify()	Proxy	Not a valid proxy user	The user with internal ID proxy_id does not exist or is marked as deleted. Verify the internal ID.
934	Add, Modify add(), modify()	Project	Error while creating project from template	Error creating a project from template. Project could not be added.
935	CreateUser, Modify createUser(), modify()	User	Invalid user tag start date	tag_start_date must not be before any existing historical tag start date for the user.
936	Add, Modify add(), modify()	Projectgroup	Error while creating project group assignments	Error creating project assignment group. The project assignment group could not be added.
937	Add, Modify add(), modify()	Agreement_to_project Attachment	Invalid agreement ID specified	An agreementid (agreement – project link) or ownerid (attachment) must be specified. The agreement with internal ID agreementid or ownerid does not exist or is marked as deleted. Verify the internal ID.
938	Add, Modify add(), modify()	Agreement_to_project	Duplicate agreement_to_project	The projectid and agreementid pair must be unique. There is already one agreement – project link between the same agreement and the same project.
939	MakeURL makeURL()	—	View is not allowed for this user	[MakeURL error] — The authenticated user does not have sufficient permission (role or filter set) to view this dashboard, invoice, or trimesheet.
940	MakeURL makeURL()	—	Dashboard view is not allowed for this project	[MakeURL error] — The dashboard is not enabled for projects in this stage. Verify the project stage configuration and the project stage for the project.
941	CreateUser, Modify createUser(), modify()	User	Invalid timezone specified for user	The timezone, when specified, must be a string containing a + or – sign, followed by a four digit offset, and optionally a single letter. Examples: –0500, +0330, +1300a.
942	Add, Modify add(), modify()	LoadedCost	Loaded costs not allowed for generic resources	The user with internal ID userid is a generic resource and project_taskid is set. Loaded cost override information at the task assignment level is not allowed if your account is confidured to allow multiple generic resource assignments on the same task.
943	Add, Modify add(), modify()	Project	Project names must be unique by customer	A project with the same name already exists for the customer with internal ID customerid. Use a different value for name.
944	Add, Modify add(), modify()	Envelope Timesheet	Invalid date	Either the start or end date is not valid. Verify the start and end date.
945	Add, Modify add(), modify()	ProjectBudgetRule	Invalid Project budget group ID specified	A project_budget_groupid must be specified. The project budget group with internal ID project_budget_groupid does not exist or is marked as deleted. Verify the internal ID.
946	Add, Modify add(), modify()	ProjectBudgetTransaction	Invalid project budget rule ID specified	A project_budget_ruleid must be specified. The project budget rule with internal ID project_budget_ruleid does not exist or is marked as deleted. Verify the internal ID.
947	Add, Modify add(), modify()	ExpensePolicy	Project already has an expense policy	There is already one expense policy associated with the project with internal ID projectid, and there can only be one expense policy per project.
948	Add, Modify add(), modify()	ExpensePolicyItem	Duplicate itemid for expense policy	There is already one expense item with the same itemid in the associated expense policy. The expense_policyid and itemid combination must be unique.
949	Add, Modify add(), modify()	AttributeDescription	Invalid Resourceprofile_type ID specified	The resource profile type with internal ID resourceprofile_typeid does not exist or is marked as deleted. Verify the internal ID.
950	Add, Modify add(), modify()	AttributeDescription	Invalid Attribute ID specified	The attribute with internal ID attributeid does not exist or is marked as deleted. Verify the internal ID.
951	Add, Modify add(), modify()	AttributeDescription	Duplicate Attribute for Resourceprofile_type	There is already one attribute with the same attributeid associated with the resource profile type with internal ID resourceprofile_typeid. The attributeid and resourceprofile_typeid combination must be unique.
952	Add, Modify add(), modify()	ProjecttaskEstimate Proxy	Duplicate entry for user	There is already a project task estimate with the same project_taskid, userid, and timesheetid. The project_taskid, userid, and timesheetid combination must be unique. There is already one proxy record with the same proxyid and the same userid. The proxyid and userid combination must be unique.
953	Add, Modify add(), modify()	ProjectBudgetRule ProjectBudgetTransaction	Missing labor subcategory	A labor_subcategory must be set for the associated project budget group when category is set to 1 (labor). See ProjectBudgetGroup.
954	Add, Modify add(), modify()	Revenue_recognition_rule	Invalid Project billing rule ID specified	A project_billing_ruleid must be specified. The project billing rule with internal ID project_billing_ruleid does not exist or is marked as deleted. Verify the internal ID.
960	Add, Modify add(), modify()	ResourceAttachment	Invalid Resource attachment type	The resource attachment type must be either CV or AVATAR.
961	Add, Modify add(), modify()	ResourceAttachment	Duplicate entry for user	There is already one resource attachment record with the same type and the same userid. A user can only have one resource attachment of the same type.
962	Add, Modify add(), modify()	ResourceAttachment	ResourceAttachment cannot by modified	The authenticated user does not have sufficient permission to add or modify a resource attachment, or the resource attachment cannot be edited.
963	Add, Modify add(), modify()	ResourceAttachment	Invalid attachment id	The attachment with internal ID attachment_id does not exist, is marked as deleted, or is not associated with the user with internal ID userid. Verify the internal ID.
964	Add, Modify add(), modify()	Attachment	Invalid ResourceAttachment id	The resource attachment with internal ID owner_id does not exist or is marked as deleted. Verify the internal ID.
965	Add, Modify add(), modify()	Attachment	File could not be saved	The attachment record was created but marked as deleted because the file could not be saved to disk. Try adding the attachment again and if the error persists, contact OpenAir Customer Support.

1000 – 1199

Error Code	Command	Object Type	Short Message	More Information
1001	Submit, Approve, Reject, Unapprove submit(), approve(), reject(), unapprove()	All approvable	Invalid state	Submit, Approve or Reject operation could not be completed. Transaction objects can only be submitted if the approval status is O (Open) or R (Rejected), can only be approved or rejected if the approval status is P (Pending approval) , and can only be unapproved if the approval status is A (Approved).
1002	Submit, Approve, Reject, Unapprove submit(), approve(), reject(), unapprove()	All approvable	Submit/Approve/Reject error	The transaction object could not be submitted, approved, or rejected. Some of the possible reasons for this error include but are not limited to the following: [Submit error] There's a problem with the transaction record, or the authenticated user does not sufficient permission to submit the transaction. [Approve/Reject error] The Approval argument was not specified in the API request. [Approve/Reject error] The authenticated user cannot approve or reject the transaction object. [Reject error] Rejection reasons [notes] must be specified. [Unapprove error] The account configuration does not allow the unapprove action, the authenticated user does not have sufficient permission to unapprove the transaction object, there are downstream transactions blocking the unapproval, or the approved transaction was exported.
1003	Submit, Approve, Reject, Unapprove submit(), approve(), reject(), unapprove()	All approvable	Submit/Approve/Reject warning	The transaction object could not be submitted, approved, or rejected because there are warnings associated with this transaction and it is not allowed to submit a transaction with warnings.
1050	Add, CreateUser, Modify add(), createUser(), modify()	HierarchyNode User	Invalid hierarchy node specified	The hierarchy node specified is not valid. If the object is a hierarchy node, verify the following conditions The hierarchy node must be part of an existing and active hierarchy. hierarchyid must be specified, and the hierarchy with this internal ID must exist and be active. If an immediate ancestor is specified, the hierarchy node with internal ID parentid must exist and must be part of the same hierarchy. If isalevel is set to 1 then levelid, isanode and recordid must be set to 0, and name must be specified. If isanode is set to 1 then name must be specified and: isalevel must be set to 0. If parentid is set then there must be a hierarchy level under the hierarchy level for the immediate ancestor. levelid must be specified, must be the internal ID of a hierarchy level, and must be part of the same hierarchy. If isalevel and isanode are both set to 0 then recordid must be specified, id must not be specified (record – hierarchy node association can be added but not modified), parentid must be the internal ID of a valid hierarchy node, and the record with internal ID recordid must not be associated already with a hierarchy node in the same hierarchy. If the object is a user, verify that all hierarchy nodes with internal IDs specified in project_access_nodes exist, are project hierarchy nodes (isanode set to 1 and hierarchy with internal ID hierarchyid has type set to project).
1051	CreateUser, Modify createUser(), modify()	User	You cannot assign multiple nodes within one hierarchy	The same object cannot be associated with more than one hierarchy node in the same hierarchy. If the object is a user, verify that all hierarchy nodes with internal IDs specified in hierarchy_node_ids belong to different hierarchies.
1100	Add, CreateUser, Modify add(), createUser(), modify()	All object types with custom fields	Invalid value specified for a checkbox custom field	The custom field type is a checkbox and the value specified for a checkbox custom field must be either 0, 1, or empty.
1101	Add, CreateUser, Modify add(), createUser(), modify()	All object types with custom fields	Value specified is not on the list of values for this custom field	The value specified for this custom field must be one of the values defined in the custom field properties. Value options can be defined for custom fields of the following types: allocation grid, dropdown, dropdown and text, multiple selection, radio group, tag.
1102	Add, Modify add(), modify()	CustField	Custom field could not be saved	The custom field properties could not be saved. Check returned error description for details. This error is also returned if you specify valuelist and the custom field is not of one of the following types: allocation grid, dropdown, dropdown and text, multiple selection, radio group, tag.
1103	Modify	CustField	Modification of the field specified is not supported	Custom field property other than valuelist cannot be modified.
1104	Add, CreateUser, Modify add(), createUser(), modify()	All object types with custom fields	This custom field value is not unique	The custom field value must be unique and the value specified is already used for another object of this type. Use a different value. Date, text and URL custom fields can be set up so that each record must have a unique value held in the custom field.
1105	Add, CreateUser, Modify add(), createUser(), modify()	All object types with custom fields	Value specified is not on the list of values in the source pick list defined for this custom field	The custom field type is a pick list, and the value specified must be an integer and the internal ID of an existing record of the type selected in the custom field List source property, or in the case of a pick list sourced from projects, the value specified must follow the format <customerid>:<projectid>, where <customerid> and <projectid> are the internal ID of an existing customer, and an existing project for this customer.
1106	Add, CreateUser, Modify add(), createUser(), modify()	All object types with custom fields	One or more inline custom fields failed to be updated	One or more custom field values could not be saved. Check returned error description for details.

1200 – 1999

Error Code	Command	Object Type	Short Message	More Information
1200	ModifyOnCondition	All	Condition not met	The condition was not met and the object was not modified. The API response includes the read and unmodified object.
1300	Add, CreateUser, Modify add(), createUser(), modify()	—	Invalid filter set specified	One or more of the filter set internal IDs specified is not valid. Verify that all filter sets with internal IDs specified in filterset_ids exist.
1400	Add, Modify add(), modify()	Timesheet	Missing start_end_month_ts flag	start_end_month_ts, when set, must be either S (start) or E (end). start_end_month_ts must be specified if associated_tmid is specified.
1401	Add, Modify add(), modify()	Timesheet	Invalid associated_tmid	The timesheet with internal ID associated_tmid is not the valid split timesheet counterpart for this timesheet. Linked split timesheets at month end must have the same userid, starts and ends date. One must have start_end_month_ts set to S and the other must have start_end_month_ts set to E.
1402	Add, Modify add(), modify()	Timesheet	Non-overlapping timesheet	To specify associated_tmid or start_end_month_ts, your account must be configured to split timesheets automatically at month end, and the linked timesheets must be across two consecutive months.
1403	Add, Modify add(), modify()	Timesheet	Cannot modify timesheet with associated_tmid	The following properties cannot be modified for either part of a split timesheet at month end (that is, if associated_tmid is not empty): userid, starts, ends.
1404	Add, Modify add(), modify()	Task	Invalid time	Either start_time or end_time value is invalid. The format for start_time and end_time must be hh:mm:ss.
1405	Add, Modify add(), modify()	Task	Illegal time range	The start_time value must be before the end_time value.
1406	Add, Modify add(), modify()	Task	No permission to edit time data	To set start_time or end_time, start and end time entry on timesheets must be enabled for your account. The Enable start and end time entry on timesheets box must be checked on the Administration > Application Settings > Timesheets > Other settings form.
1407	Add, Modify add(), modify()	Task	Invalid hours	The duration set using either decimal_hours or hours and minutes does not match the period between start_time and end_time
1408	Add, Modify add(), modify()	NewsfeedMessage Project	Invalid newsfeed	The newsfeed with internal ID newsfeedid does not exist or is marked as deleted. Verify the internal ID.
1409	Add, Modify add(), modify()	NewsfeedMessage	Both author or editor not set	Either authorid or editorid must be specified.
1410	CreateUser, Modify createUser(), modify()	User	Deactivate ns integration user	The user is a NetSuite integration administrator and cannot deactivated (active must be set to 1).
1411	CreateUser, Modify createUser(), modify()	User	Change admin role of ns integration user	The user is a NetSuite integration administrator and must be an account administrator (role cannot be changed).
1412	Add, Modify add(), modify()	Ticket	Invalid quantity	The quantity must not be 0 (zero).
1413	Add, Modify add(), modify()	Invoice	Invalid payment terms	The internal ID of the associated payment terms payment_termsid must be valid and correspond to the payment terms (terms) specified for the invoice. To specify payment_termsid, the Save Payment Terms Internal ID on Invoice Records optional feature must be enabled for the OpenAir account.
1414	Add, Modify add(), modify()	Schedulerequest	Invalid approval status	The approval_status must be specified to one of the following values: O (Open), P (Pending approval), A (Approved), R (Rejected).
1415	Add, Modify add(), modify()	Projecttask Projecttaskassign	Phase cannot be assigned	A project phase cannot have project task assignments. A project task assignment cannot be associated to the project task with internal ID projecttaskid if that project task is a phase (is_a_phase set to 1).A project task cannot be designated as a phase (is_a_phase set to 1) if there are project task assignments associated with the project task. assign_user_names cannot be set if is_a_phase is set to 1 for a project task.
1416	Add, Modify add(), modify()	Projectbillingrule	Invalid cap by customer PO	You can only set or modify the cap_by_customerpo property if all the following conditions are met: The project associated to the project billing rule is a portfolio project. The project associated to the project billing rule is associated with at least one customer PO. The billing rule is associated with a customer PO. The billing rule type is one of the following: Expense item, Purchase item, Time. The following features are enabled for your account: Portfolio Projects and Subordinate Projects. Single Billing Cap across Multiple Subprojects Within a Portfolio Project.
1417	Add, Modify add(), modify()	Projectbillingrule	Invalid project task id	You can only set or modify the project_task_id property if all the following conditions are met: project_task_id must be the internal ID of a top level phase in the project schedule. The account must be configured to require either a Service or Service 1–5 line on top level phases. The billing rule type must be ‘F’ (fixed fee billing rule).
1418	Add, Modify add(), modify()	Preference	Invalid preference settings format	The preference settings format is not valid.
1419	CreateUser, Modify createUser(), modify()	User	No full user licenses available	User cannot be granted access to modules other than Account, Expenses and Timesheets.
1420	CreateUser, Modify createUser(), modify()	User	No T&E or full user licenses available	Cannot add T&E user or mark T&E user as active.
1421	CreateUser, Modify createUser(), modify()	User	No guest or full user licenses available	Cannot add guest user or mark guest user as active.

2000 – 2999

Error Code	Command	Object Type	Short Message	More Information
2001	—	—	Invalid argument passed	There is a problem with one or more arguments in your API request. Verify the arguments.
2002	—	—	Invalid format passed	There is a problem with the format of your API request. Verify the format of your API request.