Updates an existing shift

PUT

https://api.triowfs.com/trio/api/v3/shifts/locums/{id}

Locums scoped. Shift variants are mutually exclusive (use one pattern per request): Known-time (startTime + endTime), Descriptive (descriptor + hours), or Free-form (estimatedShifts + estimatedHours + note). Status transitions are validated by the backend.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢204No Content

There is no content to send for this request, but the headers may be useful.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.triowfs.com/trio/api/v3/shifts/locums/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",
    "payClassId": "fa904d2c-f676-4c5f-877d-ae43a011cf3d",
    "startDate": "2019-08-24T14:15:22.123Z",
    "endDate": "2019-08-24T14:15:22.123Z",
    "startTime": "2019-08-24T14:15:22.123Z",
    "endTime": "2019-08-24T14:15:22.123Z",
    "descriptor": "string",
    "hours": 0,
    "estimatedShifts": 0,
    "estimatedHours": 0,
    "note": "string",
    "description": "string",
    "externalRef": {
        "id": "string",
        "name": "string",
        "link": "string"
    }
}'

Response Example

400 - Example 1

{
    "type": "string",
    "title": "string",
    "status": 0,
    "detail": "string",
    "instance": "string"
}

Modified at 2026-09-17 22:39:27

Get candidates with active privileges, or in-flight privilege submissions, within a client family.

Get the reasons that may accompany a shift status change.