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

# Update Job Initial Appointment

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

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` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values
- `412` — Precondition Failed - The request cannot be completed due to failed preconditions. Common causes: - Attempting to update a subscription with invalid topic names - Trying to create a subscription with an invalid URL - Validation errors specific to the operation
- `429` — Too Many Requests

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/revisions/3a9e3886e400/schema)