---
title: "Update Scheduled Signature Request"
method: PATCH
path: "/workflows/{id}/sign-status/scheduled-send"
tags: ["Workflows"]
---

# Update Scheduled Signature Request

`PATCH /workflows/{id}/sign-status/scheduled-send`

Update a scheduled signature request. The workflow must be on the Sign step and not yet out for signature.

**OAuth Scope required:** `public.workflows.updateScheduledSignatureRequest`

## Path parameters

- `id` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- object
  - `notifyAt` string, date-time — The ISO8601 timestamp for when the signature request should be sent out for signature.
  - `reminder` object, nullable — Set to an object to add/update reminder, null to remove, or omit to leave unchanged.
    - `daysBefore` integer, required — Number of days before the scheduled send to send the reminder email (1-7).

## Response `200`

200

- SignStatusModel
  - `signers` union[] — All signers associated with the workflow.
    - union
      - SignStatusInternalSigner
        - `name` string, required — The signer's name.
        - `email` string, required — The signer's email.
        - `roleName` string, required — The role name associated with the signer.
        - `status` 'pending' | 'declined' | 'sent' | 'viewed' | 'signed', required — The status of the signer's action on the request.
        - `isWetSigned` boolean — Indicates if the document was physically signed by the signer and then uploaded.
        - `delegates` object[]
          - `name` string — The delegate's name.
          - `email` string — The delegate's email.
        - `routingOrder` integer — Indicates the order in which a signer signs when signing is sequential. NOTE: If a signer signs with wet signature, their routing order is denoted as -1.
        - `type` 'internal', required — Indicates an internal Ironclad user.
        - `userId` string — The user ID associated with the signer.
      - SignStatusExternalSigner
        - `name` string, required — The signer's name.
        - `email` string, required — The signer's email.
        - `roleName` string, required — The role name associated with the signer.
        - `status` 'pending' | 'declined' | 'sent' | 'viewed' | 'signed', required — The status of the signer's action on the request.
        - `isWetSigned` boolean — Indicates if the document was physically signed by the signer and then uploaded.
        - `delegates` object[]
          - `name` string — The delegate's name.
          - `email` string — The delegate's email.
        - `routingOrder` integer — Indicates the order in which a signer signs when signing is sequential. NOTE: If a signer signs with wet signature, their routing order is denoted as -1.
        - `type` 'external', required — Indicates an external signer.
  - `routing` 'sequential' | 'parallel' — Indicates if routing is sequential (signatures collected in order) or parallel (all signers receive request simultaneously).
  - `status` 'not_sent' | 'sent' | 'action_required' | 'complete' — Indicates the status of the signature request. NOTE: If status is 'action_required,' that means signature tags are missing for document.
  - `requireSignedDocumentUpload` boolean — Indicates if the document requires a signed document to be uploaded.
  - `provider` 'Ironclad Clickwrap' | 'Ironclad Signature' | 'Ironclad Signature (Legacy)' | 'DocuSign' | 'Adobe Sign' | 'DropboxSign' | 'Demo' | 'None' — Indicates the signature provider used for the signature request, if any.
  - `scheduledSend` object — Present when a signature request is scheduled. Only returned when status is not_sent.
    - `notifyAt` string, date-time, required — The ISO8601 timestamp for when the signature request is scheduled to be sent.
    - `reminder` object — Reminder configuration, if set.
      - `daysBefore` integer, required — Number of days before the scheduled send when the reminder email will be sent.
      - `reminderDate` string, date-time, required — The computed ISO8601 timestamp when the reminder email will be sent.

## Other responses

- `400` — 400
- `401` — 401
- `404` — 404 not found

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)