> ## 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 several documents for signature at once

> Any number of documents, each its own request, grouped as one folder in each signer's portal.

Each recipient gets one email and one link for all of theirs, and the signing order runs across the batch: a later recipient is emailed once everyone before them has signed every document.

If any document can't be sent, none is.



## OpenAPI

````yaml post /signature/batches
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/batches:
    post:
      tags:
        - Signatures
      summary: Send several documents for signature at once
      description: >-
        Any number of documents, each its own request, grouped as one folder in
        each signer's portal.


        Each recipient gets one email and one link for all of theirs, and the
        signing order runs across the batch: a later recipient is emailed once
        everyone before them has signed every document.


        If any document can't be sent, none is.
      operationId: createSignatureBatch
      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
                      order:
                        type: integer
                        minimum: 1
                    required:
                      - name
                      - email
                  minItems: 1
                documents:
                  type: array
                  items:
                    type: object
                    properties:
                      documentId:
                        type: string
                        minLength: 1
                      blocks:
                        type: array
                        items:
                          type: object
                          properties:
                            email:
                              type: string
                              minLength: 3
                            nodeIds:
                              type: array
                              items:
                                type: string
                                minLength: 1
                          required:
                            - email
                            - nodeIds
                      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:
                      - documentId
                      - blocks
                  minItems: 1
                message:
                  type: string
                  maxLength: 2000
                name:
                  type: string
                  maxLength: 120
              required:
                - recipients
                - documents
      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
        '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.