---
title: "Update Job Initial Appointment"
method: PUT
path: "/jobs/{jobId}/initial-appointment"
tags: ["jobs"]
---

# Update Job Initial Appointment

`PUT /jobs/{jobId}/initial-appointment`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/jobs/{jobId}/initial-appointment`
- Auth: HTTP bearer

Use this endpoint to add or modify the initial appointment for a job. All datetimes should be UTC and in ISO 8601 format (suffixed with 'Z').

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Path parameters

- `jobId` string, uuid, required

## Request body

- InitialAppointmentPut
  - `startDate` string: An ISO 8601 string of the Initial Appointment's start datetime including the time component and ending with 'Z' (so in UTC). https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC)
  - `endDate` string: An ISO 8601 string of the Initial Appointment's start datetime including the time component and ending with 'Z' (so in UTC). https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC)
  - `notes` string

## Response `204`

No Content

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `412`: The request could not be completed due to the failure of a required precondition.
- `429`: The rate limit for this operation has been exceeded. Use the RateLimit-* response headers to determine when you can retry.

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)