---
title: "Create a Signed Document on a Workflow"
method: POST
path: "/workflows/{id}/upload-signed"
tags: ["Workflows"]
---

# Create a Signed Document on a Workflow

`POST /workflows/{id}/upload-signed`

Upload a fully or partially signed document to a specified workflow that is in sign step. 

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

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

POST Signed Documents Response

- union
  - object
    - `workflowId` string
    - `title` string
    - `signed` WorkflowDocumentModel
      - `version` string, required — The version ID of the document's latest version
      - `versionNumber` number, required — The latest version number of the document
      - `filename` string, required — The name of the document with the extension
      - `key` string, required — The unique key associated with the document
      - `download` string, required — The URL to download the document omitting the base URL
      - `lastModified` object — The timestamp and author of the last modification to the document
        - `timestamp` string, required — The timestamp of the last modification to the document (ISO 8601 format)
        - `author` union — The author of an activity feed item
          - object — An internal author of an activity feed item
            - `type` 'internalUser', required — The type of author
            - `companyName` string, required — The company name of the author
            - `displayName` string — The display name of the author
            - `email` string — The email of the author
            - `userId` string — The user ID of the author
          - object — An external author of an activity feed item (typically a counterparty)
            - `type` 'externalUser', required — The type of author
            - `companyName` string, required — The company name of the author
            - `displayName` string — The display name of the author
            - `email` string — The email of the author
          - object — An integration author of an activity feed item
            - `type` 'integration', required — The type of author
            - `displayName` string, required — The display name of the integration
          - object — A system author of an activity feed item
            - `type` 'system', required — The type of author
            - `displayName` 'Ironclad', required — The display name of the system
  - object
    - `workflowId` string
    - `title` string
    - `signers` object[]
      - `name` string
      - `email` string
      - `roleName` string
      - `signatureStatus` SignatureStatusModel
        - `status` 'pending' | 'sent' | 'signed' | 'declined' | 'viewed'
      - `delegates` object[]
        - `name` string
        - `email` string
    - `partiallySigned` WorkflowDocumentModel
      - `version` string, required — The version ID of the document's latest version
      - `versionNumber` number, required — The latest version number of the document
      - `filename` string, required — The name of the document with the extension
      - `key` string, required — The unique key associated with the document
      - `download` string, required — The URL to download the document omitting the base URL
      - `lastModified` object — The timestamp and author of the last modification to the document
        - `timestamp` string, required — The timestamp of the last modification to the document (ISO 8601 format)
        - `author` union — The author of an activity feed item
          - object — An internal author of an activity feed item
            - `type` 'internalUser', required — The type of author
            - `companyName` string, required — The company name of the author
            - `displayName` string — The display name of the author
            - `email` string — The email of the author
            - `userId` string — The user ID of the author
          - object — An external author of an activity feed item (typically a counterparty)
            - `type` 'externalUser', required — The type of author
            - `companyName` string, required — The company name of the author
            - `displayName` string — The display name of the author
            - `email` string — The email of the author
          - object — An integration author of an activity feed item
            - `type` 'integration', required — The type of author
            - `displayName` string, required — The display name of the integration
          - object — A system author of an activity feed item
            - `type` 'system', required — The type of author
            - `displayName` 'Ironclad', required — The display name of the system

## Other responses

- `400` — 400
- `404` — 404

---

[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)