---
title: "Update a statement schedule"
method: PATCH
path: "/v2/outreach-workflows/{workflow_id}/statement-schedule/{schedule_id}"
tags: ["outreach-workflows"]
---

# Update a statement schedule

`PATCH /v2/outreach-workflows/{workflow_id}/statement-schedule/{schedule_id}`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/outreach-workflows/{workflow_id}/statement-schedule/{schedule_id}`
- Auth: HTTP bearer

Applies partial updates: only the fields present in the request body are
changed.

## Path parameters

- `workflow_id` string, required
- `schedule_id` string, required

## Request body

- UpdateStatementScheduleRequest
  - `frequency` 'weekly' | 'biweekly' | 'monthly'
  - `day_of_week` integer, nullable
  - `day_of_month` integer, nullable
  - `week_of_month` integer, nullable
  - `email_template` string, nullable: Email template ID
  - `auto_send` boolean, nullable
  - `attach_xls` boolean, nullable
  - `include_credit_memos` boolean, nullable
  - `include_disputed_items` boolean, nullable
  - `cc` string[], nullable
  - `bcc` string[], nullable
  - `cc_secondary_contacts` boolean, nullable
  - `external_roles_to_cc` ExternalContactType[], nullable
  - `internal_roles_to_cc` InternalContactType[], nullable

## Response `200`

Successful Response

- AccountStatementScheduleResponse
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `is_active` boolean, required
  - `frequency` 'weekly' | 'biweekly' | 'monthly', required
  - `day_of_week` integer, nullable, required: Day of week (0=Monday, 6=Sunday). Required for WEEKLY/BIWEEKLY.
  - `day_of_month` integer, nullable, required: Day of month (1-31). Required for MONTHLY day-of-month mode. Falls back to last day if month is shorter.
  - `week_of_month` integer, nullable, required: Week occurrence (1-5, where 5=last). Used with day_of_week for monthly day-of-week mode.
  - `biweekly_anchor_date` string, date, nullable, required: Anchor date for biweekly cadence calculation. Required for BIWEEKLY.
  - `include_credit_memos` boolean, required
  - `include_disputed_items` boolean, required
  - `auto_send` boolean, required
  - `attach_xls` boolean, required: If True, always attach an XLS to the scheduled statement, ignoring partner.is_xls_attachments_enabled.
  - `cc` string[], nullable, required
  - `bcc` string[], nullable, required
  - `cc_secondary_contacts` boolean, required
  - `external_roles_to_cc` string[], nullable, required
  - `internal_roles_to_cc` string[], nullable, required
  - `email_template` EmailTemplateSummary, required
    - `id` string, required
    - `name` string, required
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

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