> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a document for signature

> Sends the document to people outside the workspace to sign from an emailed link, without an account.

Each recipient is given the signature blocks only they may sign.

The document is copied as it stands and made read-only until the request completes or closes; recipients see that copy, never the live document. `fields` hands empty variables (keys from the fields route) to recipients to fill in; their values are written into the table once everyone has signed.

Requires edit access.



## OpenAPI

````yaml post /signature/{documentId}/requests
openapi: 3.1.0
info:
  title: HERO API
  version: current
  description: |-
    The HERO REST API.

    See https://developers.myhero.so for the rendered docs.
servers:
  - url: https://app.myhero.so
security: []
paths:
  /signature/{documentId}/requests:
    post:
      tags:
        - Signatures
      summary: Send a document for signature
      description: >-
        Sends the document to people outside the workspace to sign from an
        emailed link, without an account.


        Each recipient is given the signature blocks only they may sign.


        The document is copied as it stands and made read-only until the request
        completes or closes; recipients see that copy, never the live document.
        `fields` hands empty variables (keys from the fields route) to
        recipients to fill in; their values are written into the table once
        everyone has signed.


        Requires edit access.
      operationId: createSignatureRequest
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: documentId
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                recipients:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        minLength: 1
                      email:
                        type: string
                        minLength: 3
                      nodeIds:
                        type: array
                        items:
                          type: string
                          minLength: 1
                        minItems: 1
                      order:
                        type: integer
                        minimum: 1
                    required:
                      - name
                      - email
                      - nodeIds
                  minItems: 1
                message:
                  type: string
                  maxLength: 2000
                fields:
                  type: array
                  items:
                    type: object
                    properties:
                      key:
                        type: string
                        minLength: 1
                      recipientEmail:
                        type: string
                        minLength: 3
                      required:
                        type: boolean
                    required:
                      - key
                      - recipientEmail
                      - required
              required:
                - recipients
      responses:
        '201':
          description: 201 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties: {}
                    additionalProperties: {}
                required:
                  - data
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
        '403':
          description: 403 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
        '409':
          description: 409 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: HERO personal access token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.