Skip to main content

Endpoint Catalog

Audience​

Developers, QA engineers, support engineers, security engineers, solution architects, and implementation partners.

Reference Content​

This page records source-verified Workforce Scheduling API behavior and boundaries.

Summary​

This is the sole authoritative inventory. It contains 25 verified endpoints: 14 native, 9 compatibility, and 2 shared operational endpoints. “No explicit requirement” means authentication or authorization middleware exists, but the endpoint itself and global configuration do not require a principal.

Native endpoints​

MethodRoutePurposeAuthenticationAuthorizationTenant enforcementValidationVerified responseClassificationSource
GET/attendance/shiftsList shifts; optionally include inactiveNo explicit requirementNoneRequired by query/contextOptional Boolean query200 standard envelope with shift list; 400 for missing tenant contextNativeAttendanceShiftPolicyEndpoints.cs
POST/attendance/shiftsCreate a shiftNo explicit requirementNoneRequired before commandTime parsing, uniqueness, domain invariants200 standard envelope; 400 validation; 409 duplicateNativeAttendanceShiftPolicyEndpoints.cs
PUT/attendance/shifts/{id}Update a shiftNo explicit requirementNoneRequired before commandInteger route, time parsing, uniqueness, domain invariants200 standard envelope; 400, 404, or 409NativeAttendanceShiftPolicyEndpoints.cs
DELETE/attendance/shifts/{id}Soft-deactivate a shiftNo explicit requirementNoneRequired before commandInteger route; active-assignment guard200 standard envelope; 400, 404, or 409NativeAttendanceShiftPolicyEndpoints.cs
GET/attendance/weekly-offsList tenant weekly-off rulesNo explicit requirementNoneRequired by query/contextNo request model200 standard envelope; 400 missing tenantNativeAttendanceShiftPolicyEndpoints.cs
PUT/attendance/weekly-offsUpsert supplied weekly-off daysNo explicit requirementNoneRequired before commandNon-empty unique, parseable weekdays200 standard envelope; 400 validationNativeAttendanceShiftPolicyEndpoints.cs
GET/attendance/policiesList attendance policiesNo explicit requirementNoneRequired by query/contextOptional Boolean query200 standard envelope; 400 missing tenantNativeAttendanceShiftPolicyEndpoints.cs
POST/attendance/policiesCreate attendance policyNo explicit requirementNoneRequired before commandUniqueness and policy/rule invariants200 standard envelope; 400 or 409NativeAttendanceShiftPolicyEndpoints.cs
PUT/attendance/policies/{id}Update attendance policyNo explicit requirementNoneRequired before commandInteger route, uniqueness, policy/rule invariants200 standard envelope; 400, 404, or 409NativeAttendanceShiftPolicyEndpoints.cs
POST/attendance/employees/{laborId}/shift-assignmentsCreate effective-dated assignmentNo explicit requirementNoneRequired before commandPositive employee, active shift, date order, no overlap200 standard envelope; 400, 404, or 409Native/FoundationAttendanceShiftPolicyEndpoints.cs
GET/attendance/employees/{laborId}/shift-assignmentsList employee assignmentsNo explicit requirementNoneRequired by query/contextInteger route only200 standard envelope; 400 missing tenantNative/FoundationAttendanceShiftPolicyEndpoints.cs
GET/attendance/employees/{laborId}/effective-policyResolve effective calculation policyNo explicit requirementNoneRequired by resolver/contextInteger route; optional date and probe hours200 standard envelope; 400 tenant/domain input failuresNative/DiagnosticAttendanceShiftPolicyEndpoints.cs
GET/attendance/audit-logsQuery configuration audit recordsNo explicit requirementNoneRequired by query/contextOptional filters and result bound200 standard envelope; 400 missing tenantNative/DiagnosticAttendanceShiftPolicyEndpoints.cs
GET/attendance/timelineQuery configuration timelineNo explicit requirementNoneRequired by query/contextOptional filters and result bound200 standard envelope; 400 missing tenantNative/DiagnosticAttendanceShiftPolicyEndpoints.cs

Compatibility endpoints​

MethodRoutePurposeAuthenticationAuthorizationTenant enforcementValidationVerified responseClassificationSource
GET/api/shiftsList active legacy-shaped shiftsNo explicit requirementNoneRequired by serviceNo request model200 bare list; 400 tenant failureCompatibility/TransitionalShiftPolicyCompatEndpoints.cs
POST/api/shiftsCreate legacy-shaped shiftNo explicit requirementAdmin-role check only when authenticatedRequired by serviceRequired name, parseable times, unique active name, domain bounds200 bare DTO; 400; 403 for authenticated non-adminCompatibility/TransitionalShiftPolicyCompatEndpoints.cs
PUT/api/shifts/{id}Update legacy-shaped shiftNo explicit requirementAdmin-role check only when authenticatedRequired by serviceInteger route, required name, parseable times, unique active name200 bare DTO; 400, 403, or 404Compatibility/TransitionalShiftPolicyCompatEndpoints.cs
DELETE/api/shifts/{id}Legacy delete behavior through deactivationNo explicit requirementAdmin-role check only when authenticatedRequired by serviceInteger route; referenced assignments are deactivated200 plain text; 400, 403, or 404Compatibility/TransitionalShiftPolicyCompatEndpoints.cs
GET/api/weekly-offsList active legacy-shaped weekly offsNo explicit requirementNoneRequired by serviceNo request model200 bare list; 400 tenant failureCompatibility/TransitionalShiftPolicyCompatEndpoints.cs
PUT/api/weekly-offsReplace complete weekly-off setNo explicit requirementAdmin-role check only when authenticatedRequired by serviceBare day-name list; blanks skipped; invalid day rejected200 bare list; 400 or 403Compatibility/TransitionalShiftPolicyCompatEndpoints.cs
GET/api/attendance/policiesList policies for existing clientsNo explicit requirementNoneRequired by query/contextOptional Boolean query200 bare list; 400 tenant failureCompatibility/TransitionalShiftPolicyCompatEndpoints.cs
POST/api/attendance/policiesCreate policy with bare responseNo explicit requirementAdmin-role check only when authenticatedRequired before commandPolicy and rule validation200 bare DTO; 400, 403, or conflict represented as 400Compatibility/TransitionalShiftPolicyCompatEndpoints.cs
PUT/api/attendance/policies/{id}Update policy with bare responseNo explicit requirementAdmin-role check only when authenticatedRequired before commandInteger route, policy and rule validation200 bare DTO; 400, 403, or 404Compatibility/TransitionalShiftPolicyCompatEndpoints.cs

Shared operational endpoints​

MethodRoutePurposeAuthenticationAuthorizationTenant enforcementValidationVerified responseClassificationSource
GET/Return service identity and runtime summaryNo explicit requirementNoneNoneNone200 standard envelopeShared/FoundationEndpointRouteBuilderExtensions.cs
GET/healthFramework health probeNo explicit requirementNoneNoneNoneFramework health responseShared/FoundationProgram.cs

Inventory exclusions​

The general Attendance API, anonymous demonstration surface, attendance-domain discovery, Leave holiday APIs, and generated documentation UI/assets are deliberately excluded from this Workforce Scheduling catalog.

Source References​

  • microservices/src/attendance-service/Api/AttendanceShiftPolicyEndpoints.cs
  • microservices/src/attendance-service/Api/ShiftPolicyCompatEndpoints.cs
  • microservices/src/attendance-service/Program.cs
  • microservices/src/shared-kernel/Extensions/EndpointRouteBuilderExtensions.cs

See Also​

Keywords​

  • Workforce Scheduling API
  • Shift endpoints
  • Attendance policy API

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20