Skip to main content

Rules and limits

The page collects in one place the rules the cabinet checks and reports by errors. For each rule it is stated where it applies.

Time tracking (tracks)​

RuleValueWhere it applies
Age of the track startThe start is no older than 7 days. For roles with the “Can create tracks retroactively” permission there is no limitMy tracks, the Add track forms
Future timeThe end of a track cannot be in the futureThe same forms
Time orderThe end is later than the startThe same forms
Time fieldsAny two of three are enough: start, end, duration. The values must be consistentThe track form
Minimum duration1 minuteThe track form
Maximum duration of one track24 hours (1440 minutes)The track form and API
DescriptionRequired, up to 2000 charactersThe track form
Duration formats1.5 (hours), 1d 2h 30m, 90 (minutes)The estimate and duration fields
Day normAbove a day in the calendar a “battery” relative to 8 hours is shownMy tracks
Time zoneA track's day is counted in the employee's time zone. If not set, Asia/Bangkok is usedReports and “My tracks”
Day of a trackA track belongs to the day on which it endedThe “Track hours” and “Time allocation” reports

Task estimates and dates​

RuleValue
Estimate storage unitMinutes. A maximum of 600,000 minutes
A parent task's estimateBy default equal to the sum of subtask estimates (the “auto” label). A manual value is marked with a yellow pencil
Start and end datesCalendar days. The time of day is not stored for a task's start and end
Subtask and releaseA subtask always belongs to the parent's release
AssigneeOnly a project team member. Disabled users cannot be chosen
TagsUp to 50 tags per task, tag length up to 100 characters, duplicates are ignored

“My work” slices​

SliceCondition
TodayToday falls between the task's start and end
WeekThe task runs during the current week (Monday to Sunday), but not today
No datesNeither start nor end is set
LaterOther tasks with dates, including past deadlines

Projects and releases​

RuleValue
Project prefixUppercase Latin letters, digits, and a hyphen, up to 10 characters. Unique
Project release typesAt least one type is required
Task types in releasesAt least one type is required. They are copied into a new release
Required release fieldsProject, name, start date, end date
Release gate “Planned → In development”Assignee, estimate, target date
Deleting a release or projectDeletes nested tasks, subtasks, and hours. Requires confirmation
Project folderA non-empty folder (with projects or subfolders) cannot be deleted

Users​

RuleValue
UsernameFrom 2 to 64 characters: Latin letters without diacritics, digits, dot, underscore, hyphen. The “@” sign and spaces are not allowed
EmailMust exactly match the email in Keycloak
Deleting yourselfYou cannot delete your own account
Assigning a role to a keyOnly your own role or a role with lower priority

Reports​

RuleValue
Maximum period of the “Track hours” report366 days
ExportCSV and XLSX contain exactly what is shown on the screen with filters applied

Resource plan​

RuleValue
OverloadThe sum of an employee's planned hours across all projects for a day is more than 8. Cells are outlined in red
Mass fillHours are set only on working days. Weekends, holidays, and shortened days get 0
Underload on “Plan–fact”The fact is below the plan by more than 20%
Overspend on “Plan–fact”The fact is above the plan by more than 10%
The “Resource spend” target85–100% of the plan
Member priorityHigh, Medium, Low. It affects only display

Notifications and integrations​

RuleValue
Element pairing codeValid for 15 minutes. Only encrypted rooms are accepted
WebhookA publicly available HTTPS address. Private and local addresses are rejected. Request signature: the X-Assist-Signature header, HMAC-SHA256 of the body with the secret
Webhook secretShown once
API key expiryNever, 30, 90, or 365 days
API key tokenShown once. A lost token cannot be recovered; the key is regenerated
API request limit180 requests per minute per address, 40 per minute for sign-in requests
IdempotencyFor changing requests the Idempotency-Key header is recommended

Field constructor​

RuleValue
Field keysnake_case: starts with a letter, lowercase Latin letters, digits, and underscore, up to 63 characters
Label dictionary keyLowercase segments separated by dots, each starting with a letter
Value history (Trackable)Available for numeric and yes/no fields of a task, and for editable dates of tasks, releases, and projects
Deleting a fieldIrreversibly deletes the column and data. Requires entering the field key

Permissions and visibility​

RuleValue
MenuBuilt from the role's page permissions
TabsBuilt from the role's tab permissions
The “Team” mode on “My work”Only the Admin and Manager roles
Board listPermissions on the “Boards” collection
The “Hide final stages” filterOn by default. If a root task is completed, its whole tree is hidden