بدنه‌های درخواست و پاسخی که عملیات از آن‌ها استفاده می‌کنند. فیلدهای الزامی علامت‌گذاری شده‌اند.
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). |