Attempts to submit a shift submission

POST

https://api.triowfs.com/trio/api/v3/shifts/{shiftId}/submissions/submit

Submits the specified shift submission as the provider or as an agency on behalf of the provider. The shift must be open or pending. If pending, the submitting provider must not have an active submission. If an agency is submitting then they must provide a candidateId. If the shift submission is successful the shift details will be returned. Returns 409 Conflict when the shift is not open or pending, the candidate has no qualifying privilege, or a submission already exists for the candidate/shift combination (the Location header then links to the shift's submissions).

Request

Authorization

Add parameter in header

x-api-key

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

A successful OK response (HTTP 200) with a typed body.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409Server Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.triowfs.com/trio/api/v3/shifts//submissions/submit' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "candidateId": "10f4deb6-fd4e-4907-a47e-355caf6e449d"
}'

Response Example

200 - Example 1

{
    "recruiter": {
        "name": "string",
        "company": "string",
        "email": "user@example.com",
        "phoneNumber": "string"
    },
    "notes": "string",
    "id": "string",
    "number": 0,
    "address": {
        "line1": "string",
        "line2": "string",
        "city": "string",
        "state": "string",
        "zip": "string"
    },
    "schedule": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "scheduleClient": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "facility": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "unit": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "profession": "string",
    "specialty": "string",
    "start": "string",
    "end": "string",
    "periodOfWork": "string",
    "duration": 0,
    "status": {
        "id": 0,
        "name": "string"
    },
    "rateType": "string",
    "rate": {
        "rateType": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string"
        },
        "isOnCall": true,
        "billRate": 0
    },
    "availableActions": [
        {
            "name": "string",
            "link": "http://example.com",
            "precedence": 0
        }
    ],
    "shiftDetailUrl": "string",
    "candidate": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "segment": {
        "id": 0,
        "name": "string"
    },
    "shiftType": {
        "id": 0,
        "name": "string"
    }
}

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

Releases a confirmed shift

Attempts to accept a shift submission