Skip to main content

WFM API

WFM endpoints exposed by the Devotel CPaaS API Base path: /api/v1/wfm Endpoint count: 33

List adherence exceptions

GET /api/v1/wfm/adherence-exceptions
List adherence exceptions, most recent first. Non-managers see only their own exceptions.
string
string (enum: pending|approved|denied|cancelled)
string (enum: system_outage|emergency_meeting|unplanned_coaching|approved_absence|training|other)
string
Inclusive lower bound (YYYY-MM-DD) on the exception start.
string
Inclusive upper bound (YYYY-MM-DD) on the exception start.
integer

GET /api/v1/wfm/adherence-exceptions/trends
Counts and excused seconds grouped by exception type and status over a date window. Non-managers aggregate only their own exceptions.
string
string
string

GET /api/v1/wfm/open-shifts

GET /api/v1/wfm/open-shifts

GET /api/v1/wfm/open-shifts/

GET /api/v1/wfm/open-shifts/{id}
string
required

GET /api/v1/wfm/open-shifts//bids

GET /api/v1/wfm/open-shifts/{id}/bids
string
required

GET /api/v1/wfm/overtime-offers

GET /api/v1/wfm/overtime-offers

GET /api/v1/wfm/overtime-offers/

GET /api/v1/wfm/overtime-offers/{id}
string
required

GET /api/v1/wfm/overtime-offers//claims

GET /api/v1/wfm/overtime-offers/{id}/claims
string
required

GET /api/v1/wfm/vto-offers

GET /api/v1/wfm/vto-offers

GET /api/v1/wfm/vto-offers/

GET /api/v1/wfm/vto-offers/{id}
string
required

GET /api/v1/wfm/vto-offers//claims

GET /api/v1/wfm/vto-offers/{id}/claims
string
required

Request an adherence exception

POST /api/v1/wfm/adherence-exceptions
File a supervisor-reviewable exception so an approved deviation (system outage, emergency meeting, unplanned coaching, …) does not count against an agent’s schedule-adherence score. Created in the pending state. Non-managers may only file exceptions for themselves.
string
required
string (enum: system_outage|emergency_meeting|unplanned_coaching|approved_absence|training|other)
required
string
required
ISO-8601 datetime with offset.
string
required
ISO-8601 datetime with offset. Must be after starts_at.
string

Approve an adherence exception

POST /api/v1/wfm/adherence-exceptions/{id}/approve
Owner/admin ratifies a pending exception — the deviation becomes excused from adherence scoring. Only pending rows may be approved.
string
required
string

Cancel an adherence exception

POST /api/v1/wfm/adherence-exceptions/{id}/cancel
The requester withdraws a still-pending exception. Non-managers may only cancel their own row. Only pending rows are cancellable.
string
required

Deny an adherence exception

POST /api/v1/wfm/adherence-exceptions/{id}/deny
Owner/admin rejects a pending exception — the deviation still counts against the agent’s adherence score. Only pending rows may be denied.
string
required
string

Adjust an agent’s leave balance

POST /api/v1/wfm/leave-balances/{agentId}/adjust
Post a manual credit or debit to an agent’s leave balance and record an adjustment ledger entry. Positive hours credit, negative hours debit; the resulting balance floors at 0. Owner/admin only.
string
required
number
required
Signed hours to apply — positive credits, negative debits. Must be non-zero and within ±100000.
string
string

POST /api/v1/wfm/open-shifts

POST /api/v1/wfm/open-shifts

POST /api/v1/wfm/open-shifts//award

POST /api/v1/wfm/open-shifts/{id}/award
string
required

POST /api/v1/wfm/open-shifts//bids

POST /api/v1/wfm/open-shifts/{id}/bids
string
required

POST /api/v1/wfm/open-shifts//bids//withdraw

POST /api/v1/wfm/open-shifts/{id}/bids/{bidId}/withdraw
string
required
string
required

POST /api/v1/wfm/open-shifts//cancel

POST /api/v1/wfm/open-shifts/{id}/cancel
string
required

POST /api/v1/wfm/overtime-offers

POST /api/v1/wfm/overtime-offers

POST /api/v1/wfm/overtime-offers//award

POST /api/v1/wfm/overtime-offers/{id}/award
string
required

POST /api/v1/wfm/overtime-offers//cancel

POST /api/v1/wfm/overtime-offers/{id}/cancel
string
required

POST /api/v1/wfm/overtime-offers//claims

POST /api/v1/wfm/overtime-offers/{id}/claims
string
required

POST /api/v1/wfm/overtime-offers//claims//withdraw

POST /api/v1/wfm/overtime-offers/{id}/claims/{claimId}/withdraw
string
required
string
required

POST /api/v1/wfm/schedules/generate

POST /api/v1/wfm/schedules/generate

POST /api/v1/wfm/schedules/generate/commit

POST /api/v1/wfm/schedules/generate/commit

POST /api/v1/wfm/vto-offers

POST /api/v1/wfm/vto-offers

POST /api/v1/wfm/vto-offers//award

POST /api/v1/wfm/vto-offers/{id}/award
string
required

POST /api/v1/wfm/vto-offers//cancel

POST /api/v1/wfm/vto-offers/{id}/cancel
string
required

POST /api/v1/wfm/vto-offers//claims

POST /api/v1/wfm/vto-offers/{id}/claims
string
required

POST /api/v1/wfm/vto-offers//claims//withdraw

POST /api/v1/wfm/vto-offers/{id}/claims/{claimId}/withdraw
string
required
string
required