ऑपरेशनों द्वारा इस्तेमाल की जाने वाली रिक्वेस्ट और रिस्पॉन्स बॉडी। ज़रूरी फ़ील्ड चिह्नित हैं।
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). |