Edit, reassign or remove a shift

PATCH

/v1/workspace/contact-center/wfm/shifts/{shift_id}

curl --request PATCH \
  --url https://api.vocapable.com/v1/workspace/contact-center/wfm/shifts/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "expected_revision": 1, "user_id": "example", "starts_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "activities": [ { "kind": "break", "starts_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "reason_code": "example" } ], "deleted": true }'

Authorizations

• HTTPBearer

Parameters

Path Parameters

shift_id

required

Shift Id

string

Request Body^required

Media typeapplication/json

CcWfmShiftUpdate

object

expected_revision

required

Expected Revision

integer

>= 1

user_id

Any of:

string

string

>= 1 characters <= 96 characters /^[A-Za-z0-9_:-]+$/

null

null

starts_at

Any of:

string

string format: date-time

null

null

ends_at

Any of:

string

string format: date-time

null

null

activities

Any of:

Array<object>

Array<object>

<= 12 items

CcWfmActivityIn

object

kind

required

Kind

string

Allowed values: break lunch meeting training coaching custom time_off

starts_at

required

Starts At

string format: date-time

ends_at

required

Ends At

string format: date-time

reason_code

Any of:

string

string

>= 1 characters <= 96 characters /^[A-Za-z0-9_:-]+$/

null

null

null

null

deleted

Any of:

boolean

boolean

null

null

Responses

200

Successful Response

Media typeapplication/json

CcWfmShift

object

id

required

Id

string

revision

required

Revision

integer

user_id

required

User Id

string

user_name

required

User Name

string

starts_at

required

Starts At

string format: date-time

ends_at

required

Ends At

string format: date-time

day

required

Day

string format: date

activities

required

Activities

Array<object>

CcWfmActivity

object

kind

required

Kind

string

Allowed values: break lunch meeting training coaching custom time_off

starts_at

required

Starts At

string format: date-time

ends_at

required

Ends At

string format: date-time

reason_code

Any of:

string

string

null

null

label

Any of:

string

string

null

null

status

required

Status

string

Allowed values: draft published

template_id

required

Any of:

string

string

null

null

origin

required

Origin

string

Allowed values: manual generated swap template

published_at

required

Any of:

string

string format: date-time

null

null

changed_since_publish

required

Changed Since Publish

boolean

can_edit

required

Can Edit

boolean

Example

{
  "activities": [
    {
      "kind": "break"
    }
  ],
  "status": "draft",
  "origin": "manual"
}

204

Removed

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}