RosterPublish or unpublish

Publish or unpublish

Needs: Roster, Read-write

Publishes draft shifts to staff, which sends notifications, or unpublishes them. Without refs it affects every draft shift in the date range.

Note: With unpublish, the key is unpublished. results has single_client_shifts and group_shifts messages for whichever kinds were touched.

curl -X POST "https://app.imploy.com.au/api/integrations/v1/shifts/publish" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "refs": [
    "a:123",
    "a:124"
  ]
}'
{
  "published": true,
  "results": {
    "single_client_shifts": "..."
  }
}
POST
/shifts/publish
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.
Content-Typestring
Required

The media type of the request body

Options: application/json
refsarray

Only these shifts, up to 500. Otherwise every draft in the range.

fromstring

YYYY-MM-DD. Needed when refs is not sent.

tostring

YYYY-MM-DD, on or after from. Needed when refs is not sent.

unpublishboolean

Unpublish instead of publish.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

Body

application/json
refsarray

Only these shifts, up to 500. Otherwise every draft in the range.

fromstring

YYYY-MM-DD. Needed when refs is not sent.

tostring

YYYY-MM-DD, on or after from. Needed when refs is not sent.

unpublishboolean

Unpublish instead of publish.

Responses

OK