RosterUpdate an appointment

Update an appointment

Needs: Roster, Read-write

Changes only the fields you send. The response lists the affected appointments in data.

curl -X PATCH "https://app.imploy.com.au/api/integrations/v1/appointments/123" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "employee_id": 32,
  "to_be_published": true
}'
{
  "data": [
    {
      "id": 55,
      "appointment_title": "Morning support",
      "client_id": 12,
      "employee_id": 32,
      "start": "2026-03-02 09:00:00",
      "end": "2026-03-02 13:00:00",
      "appointment_address": "1 Example St, Perth WA 6000",
      "is_draft": 0,
      "appointment_cancelled": 0,
      "is_deleted": 0,
      "created_at": "2026-02-20T01:00:00.000000Z",
      "updated_at": "2026-02-20T01:00:00.000000Z"
    }
  ]
}
PATCH
/appointments/{id}
PATCH
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.
path
idinteger
Required

The appointment id.

Content-Typestring
Required

The media type of the request body

Options: application/json
appointment_titlestring

Up to 200 characters. Required on create.

client_idinteger

An existing client id. Required on create.

employee_idinteger

An existing staff id, or null. Suppliers and archived staff are refused.

startstring

A date and time. Required on create.

endstring

A date and time after the start. Required on create.

appointment_addressstring

Up to 500 characters. Required on create.

appointment_typestring

A configured service name (price book or NDIS price type). Required on create.

to_be_publishedboolean

Publish to staff.

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.

Path Parameters

idinteger
Required

The appointment id.

Body

application/json
appointment_titlestring

Up to 200 characters. Required on create.

client_idinteger

An existing client id. Required on create.

employee_idinteger

An existing staff id, or null. Suppliers and archived staff are refused.

startstring

A date and time. Required on create.

endstring

A date and time after the start. Required on create.

appointment_addressstring

Up to 500 characters. Required on create.

appointment_typestring

A configured service name (price book or NDIS price type). Required on create.

to_be_publishedboolean

Publish to staff.

Responses

OK