## Error Responses
All error responses follow this structure:
```json
{
"Errors": [
{
"message": "string",
"errorCode": number,
"isBusinessException": false,
"businessExceptionData": null,
"failureServerReason": null
}
]
}
```
```json
{
"errors": [
{
"message": "Category name is required",
"errorCode": 9,
"isBusinessException": false,
"businessExceptionData": null,
"failureServerReason": null
}
]
}
```
The API may return the following error responses:1. 400 Bad Request
- When request validation fails
- When required fields are missing
- When field values are invalid
- 401 Unauthorized
- When the authentication token is missing or invalid
- When the user doesn't have required rights
- 403 Forbidden
- When location is read-only
- When user doesn't have sufficient permissions
- 404 Not Found
- When the requested task doesn't exist
- When location or category doesn't exist
- 409 Conflict
- When trying to create a duplicate task
- When a task name already exists in the specified location/category/group
## Validation Rules and status codes
0: **UnknownError** - A generic or unspecified error. Used as a fallback when the specific cause is not known.
Status: **400 Bad Request**
1–3: **Duplicate/Uniqueness Errors**- 1: **TaskNameDuplicate**: The task name already exists in the system.
- 2: **UniqueIdDuplicate**: The unique identifier for a task is already in use.
- 3: **TaskNameDuplicateInGroup**: The task name is duplicated within a specific group.
Status: **409 Conflict**
4–10: **Not Found Errors**- 4: **LocationNotFound**: The specified location does not exist.
- 5: **CategoryNotFound**: The specified category does not exist.
- 6: **GroupNotFound**: The specified group does not exist.
- 7: **TaskNotFound**: The specified task does not exist.
- 8: **RankNotFound**: The specified rank does not exist.
- 9: **ApproverRankNotFound**: The specified approver rank does not exist.
- 10: **CurrencyNotFound**: The specified currency does not exist.
Status: **404 Not Found**
11–31: **Required Field Errors**- 11: **LocationRequired**: Location is required but missing.
- 12: **CategoryRequired**: Category is required but missing.
- 13: **GroupRequired**: Group is required but missing.
- 14: **TaskRequired**: Task is required but missing.
- 15: **TaskNameRequired**: Task name is required but missing.
- 16: **TaskDescriptionRequired**: Task description is required but missing.
- 17: **UniqueIdRequired**: Unique ID is required but missing.
- 18: **IntervalRequired**: Interval value is required but missing.
- 19: **IntervalTypeRequired**: Interval type is required but missing.
- 20: **WarningIntervalRequired**: Warning interval is required but missing.
- 21: **WarningIntervalTypeRequired**: Warning interval type is required but missing.
- 22: **MaxIntervalTypeRequired**: Max interval type is required but missing.
- 23: **ProjectRanksRequired**: Project ranks are required but missing.
- 24: **DefectRanksRequired**: Defect ranks are required but missing.
- 25: **ApproverRanksRequired**: Approver ranks are required but missing.
- 26: **RunningHoursRequired**: Running hours are required but missing.
- 27: **DueDateRequired**: Due date is required but missing.
- 28: **TaskIdRequired**: Task ID is required but missing.
- 29: **RankRequired**: Rank is required but missing.
- 30: **RanksRequired**: Ranks are required but missing.
- 31: **TaskListEmptyOrNull**: The list of tasks is empty or null.
Status: **400 Bad Request**
32–34: **Length Validation Errors**
- 32: **TaskNameTooLong**: Task name exceeds the maximum allowed length.
- 33: **LocationNameTooLong**: Location name exceeds the maximum allowed length.
- 34: **UniqueIdTooLong**: Unique ID exceeds the maximum allowed length.
Status: **400 Bad Request**
35–44: **Numeric/Value Validation Errors**- 35: **GroupTypeGreaterThanZero**: Group type must be greater than zero.
- 36: **IntervalGreaterThanZero**: Interval must be greater than zero.
- 37: **WarningIntervalGreaterThanZero**: Warning interval must be greater than zero.
- 38: **MaxIntervalGreaterThanZero**: Max interval must be greater than zero.
39–41: **412 Precondition Failed**
- 39: **IntervalExceedsLimit**: Interval exceeds the allowed limit.
- 40: **WarningIntervalExceedsLimit**: Warning interval exceeds the allowed limit.
- 41: **MaxIntervalExceedsLimit**: Max interval exceeds the allowed limit.
- 42: **EstimatedBudgetAmountGreaterThanZero**: Estimated budget must be greater than zero.
- 43: **DueRunningHoursPositiveError**: Due running hours must be positive.
- 44: **DowntimeGreaterThanZero**: Downtime must be greater than zero. Status:
Others: **400 Bad Request**
45–51: **Business Rule Validation Errors**
- 45: **ProjectCannotBeCounterBased**: Projects cannot be based on counters.
- 46: **TaskCompletionApprovalNotAllowed**: Task completion approval is not allowed.
- 47: **DefectRequiresOneTimeTask**: Defect tasks must be one-time tasks.
- 48: **ApproverRankNotAllowed**: Approver rank is not allowed.
- 49: **DowntimeNotAllowed**: Downtime is not allowed.
- 50: **AttachmentNotAllowed**: Attachments are not allowed.
- 51: **PriorityNotAllowed**: Priority is not allowed. Status:
- 45, 47: **412 Precondition Failed**
- 46, 48–51: **403 Forbidden**
54–56: **Invalid/Out-of-Range Errors**
- 54: **WarningIntervalTypeInvalid**: Warning interval type is invalid.
- 55: **IntervalTypeInvalid**: Interval type is invalid.
- 56: **MaxIntervalTypeInvalid**: Max interval type is invalid.
- 57: **InvalidRanks**: Ranks are invalid
Status: **400 Bad Request**
- 58: **UserIsNotAllowedOnLocation**: User is not allowed on the specified location (**400 Bad Request**)