অপারেশনগুলো যে রিকোয়েস্ট ও রেসপন্স বডি ব্যবহার করে। আবশ্যক ফিল্ডগুলো চিহ্নিত করা আছে।
AbsenceDto
An absence.
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string (date-time) | |
createdByআবশ্যক | CalendarUserRefDto | |
daysআবশ্যক | number (double) | Σ deductionByYear; for types that do not deduct, the planned workdays (information only). |
decidedAt | string (date-time) | null | |
decidedBy | CalendarUserRefDto | null | |
decisionNote | string | null | |
deductionByYearআবশ্যক | object | The balance deduction per year, e.g. {"2026": 3.5}; empty for types that do not deduct. |
endআবশ্যক | string (date-time) | |
endDateআবশ্যক | string (date) | |
endTime | string | null | |
half | string | null | |
idআবশ্যক | string (uuid) | |
note | string | null | |
permissionsআবশ্যক | AbsencePermissionsDto | |
startআবশ্যক | string (date-time) | UTC coverage start. |
startDateআবশ্যক | string (date) | |
startTime | string | null | |
statusআবশ্যক | string | |
timeZoneআবশ্যক | string | |
typeআবশ্যক | AbsenceTypeRefDto | |
unitআবশ্যক | string | |
updatedAtআবশ্যক | string (date-time) | |
userআবশ্যক | CalendarPersonDto | |
userIdআবশ্যক | string (uuid) | |
AbsencePage
GET /v1/absences.
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | AbsenceDto[] | |
nextCursor | string | null | |
AbsencePermissionsDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
canApproveআবশ্যক | boolean | |
canCancelআবশ্যক | boolean | |
canEditআবশ্যক | boolean | |
AbsenceRequest
POST /v1/absences, PUT /v1/absences/{id} (the user never changes).
| ফিল্ড | টাইপ | বিবরণ |
|---|
endDate | string (date) | null | |
endTime | string | null | |
half | string | null | am or pm for a half day. |
note | string | null | |
startDate | string (date) | null | |
startTime | string | null | Local HH:mm for hours. |
typeId | string (uuid) | null | |
unit | string | null | days, half_day or hours. |
userId | string (uuid) | null | null = the caller. |
AbsenceTypeRefDto
The absence's type as the absence shows it; name translated for a built-in type that was not renamed.
| ফিল্ড | টাইপ | বিবরণ |
|---|
colorআবশ্যক | string | |
countsAsWorkedআবশ্যক | boolean | |
deductsFromBalanceআবশ্যক | boolean | |
idআবশ্যক | string (uuid) | |
key | string | null | |
nameআবশ্যক | string | |
paidআবশ্যক | boolean | |
timeEffectআবশ্যক | string | |
AcceptedDto
202 Accepted of a queued job.
| ফিল্ড | টাইপ | বিবরণ |
|---|
acceptedআবশ্যক | boolean | Always true. |
AccessDto
What the person may see and manage (FAZ1 AccessDto; focus_contracts::access::policy).
| ফিল্ড | টাইপ | বিবরণ |
|---|
assignableRolesআবশ্যক | string[] | |
canManageCompanySettingsআবশ্যক | boolean | |
canManageTeamsআবশ্যক | boolean | |
canManageUsersআবশ্যক | boolean | |
manageTeamIdsআবশ্যক | string[] | |
scopeআবশ্যক | string | company, teams or self. |
unassignedFallbackআবশ্যক | boolean | |
viewTeamIdsআবশ্যক | string[] | |
ActivityDayDto
One user's local day. A day without activity is a 200 with zero totals, null arrival/leave and empty lists.
| ফিল্ড | টাইপ | বিবরণ |
|---|
absenceCreditMsআবশ্যক | integer (int64) | A worked absence tops the worked time up to the expected work. |
activeMsআবশ্যক | integer (int64) | Window time ∩ not AFK (computer time only). |
afkCoverageআবশ্যক | boolean | False when no device reported AFK data (idle unknown). |
appsআবশ্যক | AppUsageDto[] | Daily totals, largest first. |
arrivalAt | string (date-time) | null | |
atWorkMsআবশ্যক | integer (int64) | |
attendance | DayAttendanceDto | null | |
categoriesআবশ্যক | CategoryUsageDto[] | Active time per category (null key = uncategorized); offline time is in no category. |
classifiedআবশ্যক | boolean | False for a day written before the Phase 2 classification (all neutral). |
dateআবশ্যক | string (date) | |
dayEndআবশ্যক | string (date-time) | |
dayStartআবশ্যক | string (date-time) | The day's window: local midnight, or the end of the previous day's night shift window. |
deletedMsআবশ্যক | integer (int64) | Tracked time removed by approved deletions (part of idle). |
domainsআবশ্যক | DomainUsageDto[] | |
hostsআবশ্যক | HostUsageDto[] | Hosts with a URL, at most 50, largest first. |
idleMsআবশ্যক | integer (int64) | |
leftAt | string (date-time) | null | |
meetingMsআবশ্যক | integer (int64) | Active time the meeting apps exception turned from idle into active. |
offlineMsআবশ্যক | integer (int64) | Approved offline time outside the tracked active time. |
pendingOfflineMsআবশ্যক | integer (int64) | Pending offline entries of the day (information only). |
plan | DayPlanDto | null | |
privateIntervalsআবশ্যক | TimeIntervalDto[] | Private intervals of the day, merged and clipped, without detail. |
privateMsআবশ্যক | integer (int64) | Private time outside active and offline time. |
productivityআবশ্যক | DayProductivityDto | |
recomputingআবশ্যক | boolean | The day waits in the recompute queue (the UI refetches every 15 s). |
slotsআবশ্যক | ActivitySlotDto[] | One entry per 5-minute UTC slot with activity, by time. |
teamId | string (uuid) | null | The user's current primary team (its rules classify the day). |
timeEntriesআবশ্যক | TimeEntryDto[] | Offline and deletion entries of every status overlapping the day's window, by start; the caller's permissions. |
timeZoneআবশ্যক | string | The zone the day was computed in; the UI draws slots at their wall-clock time in it. |
userIdআবশ্যক | string (uuid) | |
workedMsআবশ্যক | integer (int64) | activeMs + offlineMs: the denominator of productivity.productivityPct. |
ActivitySlotDto
Time in one 5-minute slot; activeMs includes approved offline time (offlineMs).
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
appsআবশ্যক | AppUsageDto[] | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
slotStartআবশ্যক | string (date-time) | |
unproductiveMsআবশ্যক | integer (int64) | |
AffectedAllocationDto
An allocation replace changed.
| ফিল্ড | টাইপ | বিবরণ |
|---|
changeআবশ্যক | string | trimmed, split or deleted. |
idআবশ্যক | string (uuid) | |
AllocationCreateRequest
POST /v1/allocations (Idempotency-Key).
| ফিল্ড | টাইপ | বিবরণ |
|---|
endedAt | string (date-time) | null | At most 24 hours after startedAt, at most 5 minutes in the future. |
isBillable | boolean | null | |
note | string | null | |
projectId | string (uuid) | null | |
replace | boolean | null | Trim, split or delete the person's (unbilled) allocations it overlaps; otherwise an overlap is 409
allocation_overlaps. |
source | string | null | manual or assignment (timer only through the timer). |
startedAt | string (date-time) | null | |
taskId | string (uuid) | null | |
userId | string (uuid) | null | null = the caller; another person needs allocations.write and to be managed by the caller. |
AllocationCreatedDto
POST /v1/allocations → 201.
AllocationDto
Time on a project.
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string (date-time) | |
createdByআবশ্যক | NamedRefDto | |
durationMsআবশ্যক | integer (int64) | |
effectiveBillableআবশ্যক | boolean | |
endedAtআবশ্যক | string (date-time) | |
idআবশ্যক | string (uuid) | |
invoiceId | string (uuid) | null | Set once the time is on an invoice. |
isBillable | boolean | null | null takes the task's, then the project's value. |
localDateআবশ্যক | string (date) | The start's day in the person's zone (rates, reports). |
note | string | null | |
permissionsআবশ্যক | AllocationPermissionsDto | |
projectআবশ্যক | ProjectRefDto | |
sourceআবশ্যক | string | timer, manual or assignment. |
startedAtআবশ্যক | string (date-time) | |
task | NamedRefDto | null | |
timeZoneআবশ্যক | string | |
updatedAtআবশ্যক | string (date-time) | |
userIdআবশ্যক | string (uuid) | |
versionআবশ্যক | integer (int64) | The row version: If-Match: "v<version>" of a change (the same value as the resource's ETag). |
AllocationPage
GET /v1/allocations.
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | AllocationDto[] | |
nextCursor | string | null | |
AllocationPermissionsDto
What the caller may do with an allocation (a billed one is locked).
| ফিল্ড | টাইপ | বিবরণ |
|---|
deleteআবশ্যক | boolean | |
editআবশ্যক | boolean | |
AppTotalDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
appKeyআবশ্যক | string | |
categoryKey | string | null | |
level | string | null | Level in the response's levelContext. |
nameআবশ্যক | string | |
percentageআবশ্যক | number (double) | Share of the range's worked time (0–100, one decimal). |
AppUsageDto
An app's time; offline rows use the reserved keys _offline_<level> with name: "Offline time" and
levelSource: "offline".
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
appKeyআবশ্যক | string | |
categoryKey | string | null | |
level | string | null | The app's own rule (productive, unproductive, neutral). |
levelSource | string | null | team, company, default or offline. |
nameআবশ্যক | string | |
BudgetDto
A project's budget: hours (minutes) or an amount in the project's currency (amountMinor).
| ফিল্ড | টাইপ | বিবরণ |
|---|
amountMinor | integer (int64) | null | |
kind | string | null | hours or amount. |
minutes | integer (int64) | null | |
BudgetRequest
The budget of a project request (kind hours with minutes, or amount with amountMinor).
| ফিল্ড | টাইপ | বিবরণ |
|---|
amountMinor | integer (int64) | null | |
kind | string | null | |
minutes | integer (int64) | null | |
CalendarDecisionRequest
{decision, note?} of the decision endpoints (approve or reject; the note at most 500 characters).
| ফিল্ড | টাইপ | বিবরণ |
|---|
decision | string | null | |
note | string | null | |
CalendarPersonDto
A user with the current team.
| ফিল্ড | টাইপ | বিবরণ |
|---|
fullName | string | null | |
idআবশ্যক | string (uuid) | |
teamId | string (uuid) | null | |
teamName | string | null | |
CalendarUserRefDto
A user reference (names from the directory; null when unknown).
| ফিল্ড | টাইপ | বিবরণ |
|---|
fullName | string | null | |
idআবশ্যক | string (uuid) | |
CapabilitiesDto
Subscription capabilities.
| ফিল্ড | টাইপ | বিবরণ |
|---|
featuresআবশ্যক | string[] | |
readOnlyআবশ্যক | boolean | |
CategoryUsageDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
categoryKey | string | null | null = uncategorized. |
CreateExportRequest
POST /v1/exports: definition is the full definition the dialog shows; without it the saved template
(templateId) or the built-in one (templateKey) gives it.
| ফিল্ড | টাইপ | বিবরণ |
|---|
definition | ExportDefinitionDto | null | |
from | string (date) | null | |
locale | string | null | tr or en. |
templateId | string (uuid) | null | |
templateKey | string | null | |
to | string (date) | null | |
CreateInvitation
POST /v1/invitations.
| ফিল্ড | টাইপ | বিবরণ |
|---|
emailআবশ্যক | string | |
fullNameআবশ্যক | string | |
locale | string | null | Language of the e-mail and the acceptance page (tr, en); the organization's default otherwise. |
roleআবশ্যক | string | admin, team_admin, manager or employee. |
teamId | string (uuid) | null | |
timeZone | string | null | |
viewerTeamIds | string (uuid)[] | |
CreateTeam
POST /v1/teams.
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | At most 500 characters. |
nameআবশ্যক | string | 1–100 characters, unique among active teams (Turkish case folding). |
CreateTimeEntryRequest
POST /v1/time-entries (the .NET CreateTimeEntryRequest).
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | Offline: 1–500 characters; deletion: optional reason (at most 500). |
end | string (date-time) | null | |
kind | string | null | offline or deletion. |
level | string | null | Offline only (default productive). |
projectId | string (uuid) | null | Must be null (400 project_not_supported). |
start | string (date-time) | null | |
userId | string (uuid) | null | null = the caller; a manager may add time for a user it manages. |
CreateWebhookEndpointRequest
POST /v1/webhook-endpoints.
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | ≤ 200 characters. |
eventTypesআবশ্যক | string[] | 1–50 catalog event types of the tenant's plan. |
urlআবশ্যক | string | https://… (≤ 2048; no user info, no fragment; every resolved address public). |
CreatedWebhookEndpointDto
CreatedWebhookEndpointDto: the endpoint and its signing secret, shown once.
| ফিল্ড | টাইপ | বিবরণ |
|---|
endpointআবশ্যক | WebhookEndpointDto | |
secretআবশ্যক | string | whsec_<base64>: shown once, never again. |
DailyHolidayDto
A holiday of a daily report day.
| ফিল্ড | টাইপ | বিবরণ |
|---|
half | string | null | |
keyআবশ্যক | string | |
nameআবশ্যক | string | English name; nameTr is the Turkish one. |
nameTrআবশ্যক | string | |
DayAbsenceDto
The dominant absence of a day (/v1/reports/users/{userId}/daily days[].absence).
| ফিল্ড | টাইপ | বিবরণ |
|---|
colorআবশ্যক | string | |
fractionআবশ্যক | number (double) | The day's approved absence coverage (0–1). |
half | string | null | |
typeKey | string | null | |
typeName | string | null | |
unitআবশ্যক | string | |
DayAttendanceDto
Attendance of the day on the day plan.
| ফিল্ড | টাইপ | বিবরণ |
|---|
expectedEnd | string (date-time) | null | |
expectedStart | string (date-time) | null | |
flexibleআবশ্যক | boolean | |
lateByMsআবশ্যক | integer (int64) | |
lateToleranceMinutesআবশ্যক | integer (int32) | |
leftEarlyআবশ্যক | boolean | |
leftEarlyByMsআবশ্যক | integer (int64) | |
statusআবশ্যক | string | onTime, late, absent, notStarted, dayOff, onLeave, holiday. |
targetMsআবশ্যক | integer (int64) | The plan's target (the Effectiveness % denominator). |
workdayআবশ্যক | boolean | |
DayPlanDto
The day plan of one user's day.
| ফিল্ড | টাইপ | বিবরণ |
|---|
absencesআবশ্যক | PlanAbsenceDto[] | Approved and pending absences covering the day (only approved ones change the numbers). |
expectedEnd | string (date-time) | null | |
expectedStart | string (date-time) | null | |
expectedWorkMsআবশ্যক | integer (int64) | Overtime target (base × (1 − fLeave)). |
holiday | HolidayRefDto | null | |
kindআবশ্যক | string | schedule, shift, dayOff or holiday. |
leaveFractionআবশ্যক | number (double) | The approved absence coverage f (0–1). |
shiftsআবশ্যক | PlanShiftDto[] | Shifts starting on the day, by start. |
targetMsআবশ্যক | integer (int64) | Effectiveness % denominator (base × (1 − f)). |
workdayআবশ্যক | boolean | |
DayProductivityDto
A day's time by productivity level (productive + unproductive + neutral = workedMs).
| ফিল্ড | টাইপ | বিবরণ |
|---|
effectivenessPct | number (double) | null | productive ÷ target × 100 (not capped); null without a target. |
neutralMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | productive ÷ worked × 100, one decimal; null without worked time. |
targetMsআবশ্যক | integer (int64) | |
unproductiveMsআবশ্যক | integer (int64) | |
DayTotalDto
One local day of a summary.
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
activeUserCountআবশ্যক | integer (int32) | |
atWorkMsআবশ্যক | integer (int64) | |
dateআবশ্যক | string (date) | |
idleMsআবশ্যক | integer (int64) | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
privateMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | |
unproductiveMsআবশ্যক | integer (int64) | |
DomainTotalDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
categoryKey | string | null | |
domainআবশ্যক | string | |
level | string | null | |
percentageআবশ্যক | number (double) | |
DomainUsageDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
categoryKey | string | null | |
domainআবশ্যক | string | |
level | string | null | |
levelSource | string | null | |
EmailVerificationDto
Where the person stands with the e-mail verification (owner decision 3 Oct 2026, focus_auth::email_gate).
| ফিল্ড | টাইপ | বিবরণ |
|---|
dueAt | string (date-time) | null | The deadline of an unverified account (Identity__EmailVerificationGraceHours after its creation). |
stateআবশ্যক | string | verified, not_required (an account that never has to verify: invited, imported, SCIM, IdP-verified),
pending (unverified, before dueAt) or overdue (after dueAt: every request but a few answers 403
email_verification_required). |
ExportDefinitionDto
What an export contains (FAZ4 §6.1; focus_contracts::reports::export::ExportDefinition on the wire); a saved
template stores it without the date range. Every field is optional so that the validator reports what is wrong
(422 validation_failed with errors[{field, code}]).
| ফিল্ড | টাইপ | বিবরণ |
|---|
columns | string[] | null | Column keys of the dataset in file order (1–40; a PDF at most 12). |
csvDialect | string | null | standard (default) or excel-tr (csv only). |
dataset | string | null | |
durationFormat | string | null | hms (default), hours or minutes. |
filters | ExportFiltersDto | null | |
format | string | null | xlsx, csv or pdf. |
groupBy | string | null | day, week, month, range or none (the dataset decides). |
options | ExportOptionsDto | null | |
ExportFiltersDto
Who is exported: a team, some users, or (neither) everyone the requester can see.
| ফিল্ড | টাইপ | বিবরণ |
|---|
includeInactiveUsers | boolean | |
teamId | string | null | |
userIds | string | null[] | null | |
ExportJobDto
An export job as the panel lists and polls it.
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string (date-time) | |
datasetআবশ্যক | string | |
errorCode | string | null | too_many_rows, too_many_rows_for_pdf, access_lost, feature_not_in_plan, canceled, internal_error. |
expiresAt | string (date-time) | null | |
fileName | string | null | |
fileSize | integer (int64) | null | |
finishedAt | string (date-time) | null | |
formatআবশ্যক | string | |
fromআবশ্যক | string (date) | |
groupBy | string | null | |
idআবশ্যক | string (uuid) | |
localeআবশ্যক | string | |
progressআবশ্যক | integer (int32) | 0–100. |
rowCount | integer (int32) | null | |
startedAt | string (date-time) | null | |
statusআবশ্যক | string | queued, running, succeeded, failed, canceled, expired. |
templateId | string (uuid) | null | |
templateKey | string | null | |
templateName | string | null | The saved template's name, while it still exists. |
toআবশ্যক | string (date) | |
ExportOptionsDto
Dataset options; each applies to one dataset and is ignored by the others.
| ফিল্ড | টাইপ | বিবরণ |
|---|
include | string | null | titles: titles, urls or both (default). |
includeCosts | boolean | null | projects (Faz 6): fill the rate, amount and currency columns (needs projects.costs.read, else 403). |
includeOpen | boolean | null | shifts: also open shifts. |
splitByUser | boolean | null | applications: one row per user and target. |
statuses | string | null[] | null | offline_time / absence: status filter (default approved). |
targetType | string | null | applications: app (default), domain or host. |
FieldError
One field error of a 400/422 body.
| ফিল্ড | টাইপ | বিবরণ |
|---|
codeআবশ্যক | string | Stable snake_case code (required, too_long, invalid, ...). |
fieldআবশ্যক | string | JSON path of the field in camelCase (name, items[2].start), or the parameter/header name. |
message | string | null | |
HolidayRefDto
A holiday of a day (both names; name is the English one).
| ফিল্ড | টাইপ | বিবরণ |
|---|
half | string | null | |
keyআবশ্যক | string | Built-in key (republic_day, …) or custom. |
nameআবশ্যক | string | |
nameEnআবশ্যক | string | |
nameTrআবশ্যক | string | |
source | string | null | builtin or tenant. |
HostUsageDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
domain | string | null | |
hostআবশ্যক | string | |
levelআবশ্যক | string | |
levelSourceআবশ্যক | string | |
matchedKey | string | null | Key of the matching domain rule; null for the default. |
InvitationEmail
What happened to the invitation e-mail.
| ফিল্ড | টাইপ | বিবরণ |
|---|
acceptUrl | string | null | The acceptance link, only when no e-mail is sent (not_configured, suppressed_reserved) and only in the
fresh answer (share it by hand). |
statusআবশ্যক | string | queued; not_configured when no e-mail provider is set up; suppressed_reserved when the address is an
RFC 2606 / RFC 6761 reserved name (example.com, *.test, …) that is never e-mailed. Clients treat
suppressed_reserved like not_configured: nothing arrives, share acceptUrl by hand. |
InvitationRef
{"id","expiresAt"} of a created or re-sent invitation.
| ফিল্ড | টাইপ | বিবরণ |
|---|
expiresAtআবশ্যক | string | |
idআবশ্যক | string (uuid) | |
InvitationResult
The answer of POST /v1/invitations and POST /v1/invitations/{id}/resend.
LevelContextDto
Which rules the single level of an aggregate list follows (FAZ2 §5 "Listelerde hangi kural").
| ফিল্ড | টাইপ | বিবরণ |
|---|
kindআবশ্যক | string | user (a userId filter: that user's current team), team (a teamId filter) or company. |
teamId | string (uuid) | null | |
MeMembership
The membership in the current organization.
| ফিল্ড | টাইপ | বিবরণ |
|---|
idআবশ্যক | string (uuid) | |
isTrackedআবশ্যক | boolean | |
joinedAt | string | null | |
roleআবশ্যক | string | |
statusআবশ্যক | string | |
teamId | string (uuid) | null | |
teamName | string | null | |
timeZone | string | null | |
viewerTeamIdsআবশ্যক | string (uuid)[] | |
MeOrganization
The current organization.
| ফিল্ড | টাইপ | বিবরণ |
|---|
defaultLocaleআবশ্যক | string | |
idআবশ্যক | string (uuid) | |
nameআবশ্যক | string | |
slugআবশ্যক | string | |
statusআবশ্যক | string | |
timeZoneআবশ্যক | string | |
MeSession
The current session.
| ফিল্ড | টাইপ | বিবরণ |
|---|
absoluteExpiresAtআবশ্যক | string | |
amrআবশ্যক | string[] | |
authTimeআবশ্যক | string | |
clientIdআবশ্যক | string | |
idআবশ্যক | string (uuid) | |
idleExpiresAtআবশ্যক | string | |
MeUser
The person (GET /v1/me → user).
| ফিল্ড | টাইপ | বিবরণ |
|---|
emailআবশ্যক | string | |
emailVerificationআবশ্যক | EmailVerificationDto | The e-mail verification gate (owner decision 3 Oct 2026). |
emailVerifiedআবশ্যক | boolean | |
fullName | string | null | |
idআবশ্যক | string (uuid) | |
localeআবশ্যক | string | |
MemberDto
A membership with its person (MemberDto).
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string | |
emailআবশ্যক | string | |
emailVerifiedআবশ্যক | boolean | |
fullName | string | null | |
idআবশ্যক | string (uuid) | |
invitation | MemberInvitationDto | null | |
isTrackedআবশ্যক | boolean | |
joinedAt | string | null | |
localeআবশ্যক | string | |
roleআবশ্যক | string | owner, admin, team_admin, manager, employee. |
statusআবশ্যক | string | invited, active, suspended, left. |
teamId | string (uuid) | null | |
teamName | string | null | |
timeZone | string | null | |
unassignedManagerআবশ্যক | boolean | A Manager with neither a team nor viewer teams (sees the whole company until assigned). |
userIdআবশ্যক | string (uuid) | |
viewerTeamIdsআবশ্যক | string (uuid)[] | |
MemberInvitationDto
The invitation of an invited member.
| ফিল্ড | টাইপ | বিবরণ |
|---|
emailStatus | string | null | queued, sending, sent, failed, suppressed, not_configured, suppressed_reserved (an RFC 2606 /
RFC 6761 reserved domain, never e-mailed), or null before the first e-mail. |
expiresAtআবশ্যক | string | |
idআবশ্যক | string (uuid) | |
lastSentAtআবশ্যক | string | |
sentCountআবশ্যক | integer (int32) | |
MemberPage
A page of members (OpenAPI).
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | MemberDto[] | |
nextCursor | string | null | |
MemberRefDto
A member as a reference (current row): the connecting Admin of a connection, the owner of a webhook endpoint.
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeআবশ্যক | boolean | The membership is active and (for an endpoint or a tenant connection) still an Owner or Admin. |
name | string | null | |
userIdআবশ্যক | string (uuid) | |
NamedRefDto
A reference by id and display name (a client, a person, a task).
| ফিল্ড | টাইপ | বিবরণ |
|---|
idআবশ্যক | string (uuid) | |
nameআবশ্যক | string | |
OrganizationChoice
One organization of the person (sec.user_memberships).
| ফিল্ড | টাইপ | বিবরণ |
|---|
currentআবশ্যক | boolean | |
idআবশ্যক | string (uuid) | |
nameআবশ্যক | string | |
roleআবশ্যক | string | |
selectableআবশ্যক | boolean | Can this session's sign-in method open it (design §4.5.3)? |
PatchMember
PATCH /v1/members/{id}.
| ফিল্ড | টাইপ | বিবরণ |
|---|
isTracked | boolean | null | |
role | string | null | admin, team_admin, manager or employee (the Owner is only transferred). |
teamId | string (uuid) | null | Primary team; null removes it. |
timeZone | string | null | IANA zone of the membership; null follows the organization. |
viewerTeamIds | string (uuid)[] | null | Extra read-only teams (Manager and TeamAdmin only). |
PatchTeam
PATCH /v1/teams/{id}.
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | |
name | string | null | |
PeriodReportDto
GET /v1/reports/productivity.
PlanAbsenceDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
colorআবশ্যক | string | |
countsAsWorkedআবশ্যক | boolean | timeEffect == worked. |
endTime | string | null | |
half | string | null | |
idআবশ্যক | string (uuid) | |
startTime | string | null | Local start and end of an hours absence. |
statusআবশ্যক | string | approved or pending. |
timeEffectআবশ্যক | string | leave, worked or none. |
typeKey | string | null | |
typeName | string | null | null for a built-in type that was not renamed (the UI translates typeKey). |
unitআবশ্যক | string | days, half_day or hours. |
PlanShiftDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
color | string | null | |
endআবশ্যক | string (date-time) | |
endTimeআবশ্যক | string | Local end; before the start for a night shift. |
idআবশ্যক | string (uuid) | |
locationআবশ্যক | string | |
minMinutesআবশ্যক | integer (int32) | |
startআবশ্যক | string (date-time) | |
startTimeআবশ্যক | string | Local start (HH:mm, the shift's zone). |
Problem
RFC 9457 problem details (application/problem+json).
| ফিল্ড | টাইপ | বিবরণ |
|---|
action | string | null | Permission key of a 403 (teams.create). |
codeআবশ্যক | string | Stable snake_case error code (catalog error-codes.json). |
detail | string | null | |
errors | FieldError[] | null | |
requiredPlan | string | null | Lowest plan that includes the feature (402 feature_not_in_plan). |
retryAfterSeconds | integer (int32) | null | Seconds to wait (429, 503; also the Retry-After header). |
statusআবশ্যক | integer (int32) | |
titleআবশ্যক | string | English title of the code (clients translate code). |
traceId | string | null | W3C trace id of the request. |
typeআবশ্যক | string | Help page of the error code: https://workify360.com/help/errors/<code>/. |
ProjectAmountDto
The amounts of one currency (rates are applied per allocation day and layer).
| ফিল্ড | টাইপ | বিবরণ |
|---|
billableMinorআবশ্যক | integer (int64) | The billable hours at their rate. |
costMinorআবশ্যক | integer (int64) | Every allocated hour at its rate. |
currencyআবশ্যক | string | |
ProjectBudgetUsageDto
The use of a project's budget, all time.
| ফিল্ড | টাইপ | বিবরণ |
|---|
budgetMinor | integer (int64) | null | null unless costsIncluded. |
budgetMinutes | integer (int64) | null | |
kindআবশ্যক | string | hours or amount. |
projectIdআবশ্যক | string (uuid) | |
usedMinor | integer (int64) | null | The cost in the project's currency; null unless costsIncluded. |
usedMsআবশ্যক | integer (int64) | |
usedRatio | string | null | Used / budget, 4 decimals (null for an amount budget without costsIncluded). |
ProjectDto
A project.
| ফিল্ড | টাইপ | বিবরণ |
|---|
accessআবশ্যক | string | everyone or members. |
archivedআবশ্যক | boolean | |
budget | BudgetDto | null | |
client | NamedRefDto | null | |
code | string | null | |
color | string | null | |
createdAtআবশ্যক | string (date-time) | |
currencyআবশ্যক | string | The currency of the project's rates and amount budget. |
description | string | null | |
endDate | string (date) | null | |
idআবশ্যক | string (uuid) | |
isBillableআবশ্যক | boolean | |
memberCountআবশ্যক | integer (int64) | |
myRole | string | null | The caller's role in the project team (member, manager), null outside it. |
nameআবশ্যক | string | |
permissionsআবশ্যক | ProjectPermissionsDto | |
spentMsআবশ্যক | integer (int64) | Every allocation of the project, all time. |
startDate | string (date) | null | |
statusআবশ্যক | string | active, on_hold or completed. |
taskCountআবশ্যক | integer (int64) | |
updatedAtআবশ্যক | string (date-time) | |
ProjectPage
GET /v1/projects.
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | ProjectDto[] | |
nextCursor | string | null | |
ProjectPermissionsDto
What the caller may do with a project (decided from the current rows, §5.3).
| ফিল্ড | টাইপ | বিবরণ |
|---|
archiveআবশ্যক | boolean | |
deleteআবশ্যক | boolean | Only a project without time. |
editআবশ্যক | boolean | The project's fields (Owners and Admins). |
manageMembersআবশ্যক | boolean | The team (an Admin or the project's manager; only an Admin changes managers). |
manageTasksআবশ্যক | boolean | Tasks (an Admin or the project's manager). |
trackআবশ্যক | boolean | The caller may track time on it now. |
ProjectRefDto
A project reference of an allocation.
| ফিল্ড | টাইপ | বিবরণ |
|---|
color | string | null | #RRGGBB. |
idআবশ্যক | string (uuid) | |
nameআবশ্যক | string | |
ProjectReportDto
GET /v1/reports/projects.
ProjectReportKeysDto
The dimensions of a row (the ones not grouped by are null).
| ফিল্ড | টাইপ | বিবরণ |
|---|
clientId | string (uuid) | null | |
clientName | string | null | |
date | string (date) | null | The allocation's local day (groupBy day). |
projectId | string (uuid) | null | |
projectName | string | null | |
taskId | string (uuid) | null | |
taskName | string | null | |
userId | string (uuid) | null | |
userName | string | null | |
ProjectReportRowDto
One row of the project report.
| ফিল্ড | টাইপ | বিবরণ |
|---|
allocatedMsআবশ্যক | integer (int64) | |
amounts | ProjectAmountDto[] | null | null unless costsIncluded. |
billableMsআবশ্যক | integer (int64) | |
keysআবশ্যক | ProjectReportKeysDto | |
nonBillableMsআবশ্যক | integer (int64) | |
productiveMs | integer (int64) | null | With includeProductive only. |
unratedMsআবশ্যক | integer (int64) | Time without any rate (it is left out of the amounts). |
ProjectReportTotalsDto
The totals of the report.
| ফিল্ড | টাইপ | বিবরণ |
|---|
allocatedMsআবশ্যক | integer (int64) | |
amounts | ProjectAmountDto[] | null | |
billableMsআবশ্যক | integer (int64) | |
nonBillableMsআবশ্যক | integer (int64) | |
productiveMs | integer (int64) | null | |
unratedMsআবশ্যক | integer (int64) | |
ProjectRequest
POST /v1/projects; PUT /v1/projects/{id} sends the whole body.
| ফিল্ড | টাইপ | বিবরণ |
|---|
access | string | null | everyone (default) or members. |
budget | BudgetRequest | null | |
clientId | string (uuid) | null | |
code | string | null | [A-Za-z0-9._-]{1,32}, unique among active projects. |
color | string | null | #RRGGBB. |
currency | string | null | TRY, USD or EUR; locked once the project has rates or invoice lines (409 project_currency_locked). |
description | string | null | |
endDate | string (date) | null | |
isBillable | boolean | null | Default true. |
name | string | null | |
startDate | string (date) | null | |
status | string | null | active (default), on_hold or completed. |
ReportPeriodDto
One period of a grouped report: its key and bounds, then the figures.
ReportScopeDto
What the caller can see (FAZ1 AccessPolicy.ScopeOf).
| ফিল্ড | টাইপ | বিবরণ |
|---|
kindআবশ্যক | string | company, teams or self. |
teamIdsআবশ্যক | string (uuid)[] | The visible teams of a teams scope, sorted; empty otherwise (company = all). |
unassignedFallbackআবশ্যক | boolean | A Manager without teams who sees the whole company until assigned. |
ReportSubjectDto
Whom a report is about.
| ফিল্ড | টাইপ | বিবরণ |
|---|
id | string (uuid) | null | |
kindআবশ্যক | string | company, team or user. |
name | string | null | |
RotatedWebhookSecretDto
RotatedWebhookSecretDto: the new signing secret, shown once.
| ফিল্ড | টাইপ | বিবরণ |
|---|
previousSecretExpiresAtআবশ্যক | string | Until then deliveries carry both signatures. |
secretআবশ্যক | string | whsec_<base64>: shown once, never again. |
ShiftBody
ShiftBody of POST /v1/shifts, the bulk items and PUT /v1/shifts/{id} (the whole body). Fields left null are
filled from templateId.
| ফিল্ড | টাইপ | বিবরণ |
|---|
breakMinutes | integer (int32) | null | |
color | string | null | |
date | string (date) | null | |
endTime | string | null | |
location | string | null | |
minMinutes | integer (int32) | null | null = the template's, else duration − break. |
note | string | null | |
startTime | string | null | |
teamId | string (uuid) | null | Required for an open shift; ignored for an assigned one (the user's current team is written). |
templateId | string (uuid) | null | |
userId | string (uuid) | null | null = an open shift. |
ShiftDto
A shift: local fields, UTC instants, the caller's permissions.
| ফিল্ড | টাইপ | বিবরণ |
|---|
breakMinutesআবশ্যক | integer (int32) | |
color | string | null | |
createdAtআবশ্যক | string (date-time) | |
createdByআবশ্যক | CalendarUserRefDto | |
crossesMidnightআবশ্যক | boolean | |
dateআবশ্যক | string (date) | |
durationMinutesআবশ্যক | integer (int32) | |
endআবশ্যক | string (date-time) | |
endTimeআবশ্যক | string | |
idআবশ্যক | string (uuid) | |
locationআবশ্যক | string | |
minMinutesআবশ্যক | integer (int32) | |
note | string | null | |
openআবশ্যক | boolean | No user assigned. |
permissionsআবশ্যক | ShiftPermissionsDto | |
sourceআবশ্যক | string | manual, template, copy or request. |
startআবশ্যক | string (date-time) | |
startTimeআবশ্যক | string | |
teamId | string (uuid) | null | Open shift: its team; assigned: the user's team when it was written. |
teamName | string | null | |
templateId | string (uuid) | null | |
templateName | string | null | |
timeZoneআবশ্যক | string | |
updatedAtআবশ্যক | string (date-time) | |
user | CalendarUserRefDto | null | |
userId | string (uuid) | null | null for an open shift. |
ShiftListDto
GET /v1/shifts (the shifts **starting** in the range).
ShiftPermissionsDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
canDeleteআবশ্যক | boolean | |
canEditআবশ্যক | boolean | |
canPickUpআবশ্যক | boolean | |
canRequestSwapআবশ্যক | boolean | |
SummaryDto
The summary of the visible users over a range.
| ফিল্ড | টাইপ | বিবরণ |
|---|
absenceCreditMsআবশ্যক | integer (int64) | |
absentDaysআবশ্যক | integer (int32) | |
activeMsআবশ্যক | integer (int64) | |
activeUserCountআবশ্যক | integer (int32) | |
atWorkMsআবশ্যক | integer (int64) | |
daysআবশ্যক | DayTotalDto[] | |
deletedMsআবশ্যক | integer (int64) | |
domainsআবশ্যক | DomainTotalDto[] | Top 10. |
effectivenessPct | number (double) | null | Average of the users' range Effectiveness % (inactive tracked users included). |
fromআবশ্যক | string (date) | |
holidayDaysআবশ্যক | number (double) | |
idleMsআবশ্যক | integer (int64) | |
inactiveUsersআবশ্যক | UserTotalDto[] | Tracked users without activity in the range (zero totals, attendance fields), by user id. |
lateDaysআবশ্যক | integer (int32) | |
leaveDaysআবশ্যক | number (double) | |
leftEarlyDaysআবশ্যক | integer (int32) | |
levelContextআবশ্যক | LevelContextDto | |
meetingMsআবশ্যক | integer (int64) | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
overtimeMsআবশ্যক | integer (int64) | |
privateMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | Average of the users' range Productivity %. |
scopeআবশ্যক | ReportScopeDto | |
shiftDaysআবশ্যক | integer (int32) | |
teamsআবশ্যক | TeamTotalDto[] | By current team: named teams by name, the teamId: null row last. |
toআবশ্যক | string (date) | |
topAppsআবশ্যক | AppTotalDto[] | Top 10; name is "Offline time" for the reserved offline keys. |
unproductiveMsআবশ্যক | integer (int64) | |
usersআবশ্যক | UserTotalDto[] | One row per user with a computed day in the range, by activeMs. |
workedMsআবশ্যক | integer (int64) | |
TargetItemDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
activeMsআবশ্যক | integer (int64) | |
categoryKey | string | null | |
categorySourceআবশ্যক | string | tenant, builtin or none. |
domain | string | null | |
levelআবশ্যক | string | |
levelSourceআবশ্যক | string | team, company or default. |
matchedKey | string | null | |
nameআবশ্যক | string | |
percentageআবশ্যক | number (double) | |
targetKeyআবশ্যক | string | |
targetTypeআবশ্যক | string | app for apps, domain for domains and hosts. |
userCountআবশ্যক | integer (int32) | |
TargetListDto
The "Apps & URLs" list.
| ফিল্ড | টাইপ | বিবরণ |
|---|
fromআবশ্যক | string (date) | |
itemsআবশ্যক | TargetItemDto[] | By active time descending, then key. |
levelContextআবশ্যক | LevelContextDto | |
nextCursor | string | null | |
toআবশ্যক | string (date) | |
totalআবশ্যক | integer (int32) | Targets matching the filters (before paging). |
totalActiveMsআবশ্যক | integer (int64) | Active time over every target of the type before the filters (the percentage base). |
typeআবশ্যক | string | app, domain or host. |
TaskDto
A task.
| ফিল্ড | টাইপ | বিবরণ |
|---|
archivedআবশ্যক | boolean | |
assignee | NamedRefDto | null | |
createdAtআবশ্যক | string (date-time) | |
description | string | null | |
dueDate | string (date) | null | |
effectiveBillableআবশ্যক | boolean | |
estimateMinutes | integer (int64) | null | |
idআবশ্যক | string (uuid) | |
isBillable | boolean | null | null takes the project's value. |
nameআবশ্যক | string | |
permissionsআবশ্যক | TaskPermissionsDto | |
projectIdআবশ্যক | string (uuid) | |
sortOrderআবশ্যক | integer (int64) | |
spentMsআবশ্যক | integer (int64) | |
statusআবশ্যক | string | open, in_progress or done. |
updatedAtআবশ্যক | string (date-time) | |
TaskPage
GET /v1/projects/{id}/tasks.
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | TaskDto[] | |
nextCursor | string | null | |
TaskPermissionsDto
What the caller may do with a task.
| ফিল্ড | টাইপ | বিবরণ |
|---|
deleteআবশ্যক | boolean | Only a task without time. |
editআবশ্যক | boolean | |
TaskRequest
POST /v1/projects/{id}/tasks; PUT /v1/tasks/{id} sends the whole body.
| ফিল্ড | টাইপ | বিবরণ |
|---|
assigneeUserId | string (uuid) | null | Must be able to track time on the project (422 project_not_trackable). |
description | string | null | |
dueDate | string (date) | null | |
estimateMinutes | integer (int64) | null | 1–1 000 000. |
isBillable | boolean | null | null takes the project's value. |
name | string | null | |
sortOrder | integer (int64) | null | |
status | string | null | open (default), in_progress or done. |
TeamDto
A team with its size and leads (TeamDto).
| ফিল্ড | টাইপ | বিবরণ |
|---|
archivedAt | string | null | |
createdAtআবশ্যক | string | |
description | string | null | |
idআবশ্যক | string (uuid) | |
leadsআবশ্যক | object[] | TeamAdmins and Managers of the team: [{membershipId, userId, fullName, role}]. |
memberCountআবশ্যক | integer (int64) | Members whose primary team this is (left members excluded). |
nameআবশ্যক | string | |
updatedAtআবশ্যক | string | |
TeamPage
A page of teams (OpenAPI).
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | TeamDto[] | |
nextCursor | string | null | |
TeamTotalDto
One team row of a summary (current teams; percentages the members' average).
| ফিল্ড | টাইপ | বিবরণ |
|---|
absenceCreditMsআবশ্যক | integer (int64) | |
absentDaysআবশ্যক | integer (int32) | |
activeMsআবশ্যক | integer (int64) | |
activeUserCountআবশ্যক | integer (int32) | |
effectivenessPct | number (double) | null | |
holidayDaysআবশ্যক | number (double) | |
idleMsআবশ্যক | integer (int64) | |
lateDaysআবশ্যক | integer (int32) | |
leaveDaysআবশ্যক | number (double) | |
leftEarlyDaysআবশ্যক | integer (int32) | |
memberCountআবশ্যক | integer (int32) | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
overtimeMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | |
shiftDaysআবশ্যক | integer (int32) | |
teamId | string (uuid) | null | null for the users without a team. |
teamName | string | null | |
unproductiveMsআবশ্যক | integer (int64) | |
workedMsআবশ্যক | integer (int64) | |
TimeEntryDecisionRequest
POST /v1/time-entries/{id}/decision.
| ফিল্ড | টাইপ | বিবরণ |
|---|
decision | string | null | approve or reject. |
note | string | null | At most 500 characters. |
TimeEntryDto
An offline entry or a deletion (design §8.2).
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string (date-time) | |
createdByআবশ্যক | TimeEntryUserRefDto | |
dateআবশ্যক | string (date) | The user's local day of the entry, in the zone effective when it was written. |
decidedAt | string (date-time) | null | |
decidedBy | TimeEntryUserRefDto | null | |
decisionNote | string | null | |
description | string | null | |
durationMsআবশ্যক | integer (int64) | |
endআবশ্যক | string (date-time) | |
idআবশ্যক | string (uuid) | |
kindআবশ্যক | string | offline or deletion. |
level | string | null | Offline: productive, neutral or unproductive; deletion: null. |
permissionsআবশ্যক | TimeEntryPermissionsDto | |
projectId | string (uuid) | null | Always null until projects (Phase 6). |
sourceআবশ্যক | string | manual (Phase 8 adds calendar). |
startআবশ্যক | string (date-time) | |
statusআবশ্যক | string | pending, approved or rejected. |
timeZoneআবশ্যক | string | |
updatedAtআবশ্যক | string (date-time) | |
userIdআবশ্যক | string (uuid) | |
TimeEntryPage
GET /v1/time-entries: by start.
| ফিল্ড | টাইপ | বিবরণ |
|---|
itemsআবশ্যক | TimeEntryDto[] | |
nextCursor | string | null | |
TimeEntryPermissionsDto
What the caller may do with the entry (TimeEntryPolicy.PermissionsFor), the same on every endpoint.
| ফিল্ড | টাইপ | বিবরণ |
|---|
canApproveআবশ্যক | boolean | |
canDeleteআবশ্যক | boolean | |
canEditআবশ্যক | boolean | |
TimeEntryUserRefDto
A user reference of an entry (fullName from the directory; null when unknown).
| ফিল্ড | টাইপ | বিবরণ |
|---|
fullName | string | null | |
idআবশ্যক | string (uuid) | |
TimeIntervalDto
A UTC interval without any detail (e.g. a private interval).
| ফিল্ড | টাইপ | বিবরণ |
|---|
endআবশ্যক | string (date-time) | |
startআবশ্যক | string (date-time) | |
TimerAtRequest
POST /v1/me/timer/stop and /discard.
| ফিল্ড | টাইপ | বিবরণ |
|---|
at | string (date-time) | null | |
TimerCommandResultDto
The result of a command (200 also when it did not apply).
| ফিল্ড | টাইপ | বিবরণ |
|---|
appliedআবশ্যক | boolean | |
closedআবশ্যক | AllocationDto[] | The allocations written from the segment this command closed (may be empty). |
reason | string | null | stale, not_running or unchanged; null when applied. |
timerআবশ্যক | TimerDto | |
TimerDto
GET /v1/me/timer (ETag: "v<rowVersion>", "v0" before the first command).
| ফিল্ড | টাইপ | বিবরণ |
|---|
autoStopAt | string (date-time) | null | startedAt + 24 hours. |
effectiveBillable | boolean | null | |
isBillable | boolean | null | |
last | TimerLastDto | null | |
note | string | null | |
project | TimerProjectDto | null | |
segmentId | string (uuid) | null | |
serverTimeআবশ্যক | string (date-time) | The server's clock (clients compute the elapsed time against it). |
source | string | null | web, desktop or api. |
startedAt | string (date-time) | null | |
stateআবশ্যক | string | running or stopped. |
task | NamedRefDto | null | |
TimerLastDto
The segment that ended last.
| ফিল্ড | টাইপ | বিবরণ |
|---|
endReasonআবশ্যক | string | stop, switch, autostop or discard. |
endedAtআবশ্যক | string (date-time) | |
segmentIdআবশ্যক | string (uuid) | |
startedAtআবশ্যক | string (date-time) | |
TimerProjectDto
The project of the running segment.
| ফিল্ড | টাইপ | বিবরণ |
|---|
clientName | string | null | |
color | string | null | |
idআবশ্যক | string (uuid) | |
nameআবশ্যক | string | |
TimerStartRequest
POST /v1/me/timer/start (Idempotency-Key: the client's command id): start, or switch while running.
| ফিল্ড | টাইপ | বিবরণ |
|---|
at | string (date-time) | null | The client's clock when the command was given (default: the server's now; at most 5 minutes ahead, at most 7
days back). |
isBillable | boolean | null | |
note | string | null | |
projectId | string (uuid) | null | |
source | string | null | web (default), desktop or api. |
taskId | string (uuid) | null | |
UpdateTimeEntryRequest
PUT /v1/time-entries/{id}: the whole editable body (kind and user never change; If-Match instead of version).
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | |
end | string (date-time) | null | |
level | string | null | |
projectId | string (uuid) | null | |
start | string (date-time) | null | |
UpdateWebhookEndpointRequest
PATCH /v1/webhook-endpoints/{id} (If-Match).
| ফিল্ড | টাইপ | বিবরণ |
|---|
description | string | null | null clears it. |
eventTypes | string[] | null | |
status | string | null | active (also opens a disabled endpoint and resets its failure counters) or paused. |
takeOver | boolean | null | true: the caller becomes the endpoint's owner (lifts an owner_inactive pause). |
url | string | null | |
UserDailyDto
A user's days: computed days plus the workdays without activity up to the user's today.
| ফিল্ড | টাইপ | বিবরণ |
|---|
daysআবশ্যক | UserDayDto[] | |
fromআবশ্যক | string (date) | |
teamId | string (uuid) | null | The user's current primary team (its rules classify every day). |
timeZoneআবশ্যক | string | |
toআবশ্যক | string (date) | |
userIdআবশ্যক | string (uuid) | |
UserDayDto
| ফিল্ড | টাইপ | বিবরণ |
|---|
absence | DayAbsenceDto | null | |
absenceCreditMsআবশ্যক | integer (int64) | |
activeMsআবশ্যক | integer (int64) | |
afkCoverageআবশ্যক | boolean | |
arrivalAt | string (date-time) | null | |
atWorkMsআবশ্যক | integer (int64) | |
attendanceStatus | string | null | onTime, late, absent, notStarted, dayOff, onLeave, holiday; null outside the directory. |
classifiedআবশ্যক | boolean | |
dateআবশ্যক | string (date) | |
dayOffWorkedMsআবশ্যক | integer (int64) | |
deletedMsআবশ্যক | integer (int64) | |
effectivenessPct | number (double) | null | |
eventCountআবশ্যক | integer (int64) | |
expectedWorkMsআবশ্যক | integer (int64) | |
holiday | DailyHolidayDto | null | |
idleMsআবশ্যক | integer (int64) | |
lateByMsআবশ্যক | integer (int64) | |
leftAt | string (date-time) | null | |
leftEarlyআবশ্যক | boolean | |
leftEarlyByMsআবশ্যক | integer (int64) | |
meetingMsআবশ্যক | integer (int64) | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
overtimeMsআবশ্যক | integer (int64) | |
planKind | string | null | schedule, shift, dayOff or holiday. |
privateMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | |
shiftCountআবশ্যক | integer (int32) | |
targetMsআবশ্যক | integer (int64) | |
topApp | string | null | Display name of the app with the most active time. |
unproductiveMsআবশ্যক | integer (int64) | |
workday | boolean | null | |
workedMsআবশ্যক | integer (int64) | |
UserTotalDto
One user of a summary.
| ফিল্ড | টাইপ | বিবরণ |
|---|
absenceCreditMsআবশ্যক | integer (int64) | |
absentDays | integer (int32) | null | Only for tracked users. |
activeDaysআবশ্যক | integer (int32) | Local days with active time. |
activeMsআবশ্যক | integer (int64) | |
arrivalAt | string (date-time) | null | Earliest arrival and latest leave in the range. |
atWorkMsআবশ্যক | integer (int64) | |
classifiedDaysআবশ্যক | integer (int32) | |
dayOffWorkedMsআবশ্যক | integer (int64) | |
deletedMsআবশ্যক | integer (int64) | |
effectivenessPct | number (double) | null | null without a target and for users missing from the directory. |
email | string | null | |
eventCountআবশ্যক | integer (int64) | |
fullName | string | null | |
holidayDaysআবশ্যক | number (double) | |
idleMsআবশ্যক | integer (int64) | |
lateDays | integer (int32) | null | |
leaveDaysআবশ্যক | number (double) | |
leftAt | string (date-time) | null | |
leftEarlyDays | integer (int32) | null | |
meetingMsআবশ্যক | integer (int64) | |
neutralMsআবশ্যক | integer (int64) | |
offlineMsআবশ্যক | integer (int64) | |
overtimeDaysআবশ্যক | integer (int32) | |
overtimeMsআবশ্যক | integer (int64) | |
privateMsআবশ্যক | integer (int64) | |
productiveMsআবশ্যক | integer (int64) | |
productivityPct | number (double) | null | |
shiftDaysআবশ্যক | integer (int32) | |
targetMs | integer (int64) | null | |
teamId | string (uuid) | null | |
teamName | string | null | |
timeZoneআবশ্যক | string | |
unproductiveMsআবশ্যক | integer (int64) | |
userIdআবশ্যক | string (uuid) | |
workdays | integer (int32) | null | |
workedMsআবশ্যক | integer (int64) | |
WebhookDeliveryDetailDto
GET /v1/webhook-endpoints/{id}/deliveries/{deliveryId}: the delivery and the body that was (or is) sent.
WebhookDeliveryDto
WebhookDeliveryDto.
| ফিল্ড | টাইপ | বিবরণ |
|---|
attemptsআবশ্যক | integer (int32) | |
createdAtআবশ্যক | string | |
deliveredAt | string | null | |
eventIdআবশ্যক | string (uuid) | The webhook-id header. |
eventTypeআবশ্যক | string | |
idআবশ্যক | string | A 64-bit integer as a string. |
lastDurationMs | integer (int32) | null | |
lastError | string | null | timeout, connect, tls, not_allowed, http_<code>, not_in_plan, owner_inactive. |
lastStatusCode | integer (int32) | null | |
nextAttemptAt | string | null | |
statusআবশ্যক | string | pending, succeeded, failed, dead. |
WebhookDeliveryPage
GET /v1/webhook-endpoints/{id}/deliveries (newest first).
WebhookEndpointDto
WebhookEndpointDto.
| ফিল্ড | টাইপ | বিবরণ |
|---|
createdAtআবশ্যক | string | |
description | string | null | |
eventTypesআবশ্যক | string[] | |
idআবশ্যক | string (uuid) | |
ownerআবশ্যক | MemberRefDto | The member who owns the endpoint (G1: a delivery needs an active Owner or Admin owner). |
previousSecretExpiresAt | string | null | After a rotation the previous secret still signs until then (24 hours). |
secretPrefixআবশ্যক | string | The first 8 characters of the signing secret (whsec_Kx); never the secret. |
statsআবশ্যক | WebhookEndpointStatsDto | |
statusআবশ্যক | string | active, paused, disabled. |
statusReason | string | null | manual, owner_inactive, failing, gone; null while active. |
updatedAtআবশ্যক | string | |
urlআবশ্যক | string | |
versionআবশ্যক | integer (int64) | row_version (ETag: "v<n>", If-Match of PATCH). |
WebhookEndpointPage
GET /v1/webhook-endpoints.
WebhookEndpointStatsDto
The delivery statistics of an endpoint.
| ফিল্ড | টাইপ | বিবরণ |
|---|
consecutiveFailuresআবশ্যক | integer (int32) | |
lastFailureAt | string | null | |
lastSuccessAt | string | null | |
WebhookEventDto
One event type of GET /v1/webhook-events.
| ফিল্ড | টাইপ | বিবরণ |
|---|
availableআবশ্যক | boolean | The tenant's plan has the feature: an endpoint may subscribe. |
descriptionআবশ্যক | string | One English sentence (the panel translates by type). |
feature | string | null | The plan feature the event needs (null: every plan with api_access). |
objectআবশ্যক | string | The data.object of the delivery body. |
typeআবশ্যক | string | <object>.<verb>, e.g. time_entry.approved. |
WebhookEventsDto
GET /v1/webhook-events.
WebhookTestDto
202 of POST /v1/webhook-endpoints/{id}/test.
| ফিল্ড | টাইপ | বিবরণ |
|---|
deliveryIdআবশ্যক | string | The delivery of the test event (a string: the deliveries' id is a 64-bit integer). |