---
title: "Update a workflow (partial)"
method: PATCH
path: "/appointments/workflows/{workflow_id}"
tags: ["Appointments"]
---

# Update a workflow (partial)

`PATCH /appointments/workflows/{workflow_id}`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/workflows/{workflow_id}`
- Auth: HTTP bearer

Partially update a workflow. Only the fields you send are changed; omit a
field to leave it as-is. Steps are replaced wholesale when provided.

## Path parameters

- `workflow_id` integer, required: Workflow integer ID.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- UpdateWorkflowRequest
  - `name` string, nullable
  - `trigger` 'new_booking' | 'before_event' | 'after_event' | 'booking_cancelled' | 'booking_rescheduled', nullable
  - `time` integer, nullable
  - `time_unit` 'minutes' | 'hours' | 'days', nullable
  - `is_active_on_all` boolean, nullable
  - `event_type_ids` integer[], nullable
  - `steps` WorkflowStepInput[], nullable
    - `action` 'email_host' | 'email_attendee' | 'email_address', required
    - `template` 'reminder' | 'custom' | 'cancelled' | 'rescheduled' | 'completed' | 'rating'
    - `email_subject` string, nullable
    - `reminder_body` string, nullable
    - `send_to` string, email, nullable
    - `sender` string, nullable
    - `include_calendar_event` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)