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

# Submit the signer's field values and signature

> The signing action (spec §5.5): validates ownership and required-field completeness, persists values, appends `participant.signed` with audit facts, and advances to the next participant — or, when this was the final signer, triggers artifact generation (the envelope stays `in_progress` until artifacts exist; §4 status never lies). Replaying after success is an idempotent 200. Requires prior consent. An optional `identity` corrects the sender-provided name/company/title the signer's auto-filled fields derive from, evidenced by `participant.details_corrected`.



## OpenAPI

````yaml /openapi.json post /api/signer/submit
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/signer/submit:
    post:
      tags:
        - signer
      summary: Submit the signer's field values and signature
      description: >-
        The signing action (spec §5.5): validates ownership and required-field
        completeness, persists values, appends `participant.signed` with audit
        facts, and advances to the next participant — or, when this was the
        final signer, triggers artifact generation (the envelope stays
        `in_progress` until artifacts exist; §4 status never lies). Replaying
        after success is an idempotent 200. Requires prior consent. An optional
        `identity` corrects the sender-provided name/company/title the signer's
        auto-filled fields derive from, evidenced by
        `participant.details_corrected`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                values:
                  type: object
                  additionalProperties:
                    type: string
                    maxLength: 262144
                signatureMethods:
                  type: object
                  additionalProperties:
                    type: string
                    enum:
                      - drawn
                      - typed
                      - uploaded
                identity:
                  type: object
                  properties:
                    name:
                      type: string
                      minLength: 1
                      maxLength: 200
                    company:
                      type: string
                      nullable: true
                      maxLength: 200
                    title:
                      type: string
                      nullable: true
                      maxLength: 200
              required:
                - values
      responses:
        '200':
          description: Signature recorded (or already recorded)
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - draft
                      - detecting
                      - review
                      - in_progress
                      - completed
                      - declined
                      - voided
                      - expired
                  allParticipantsSigned:
                    type: boolean
                  alreadySigned:
                    type: boolean
                required:
                  - status
                  - allParticipantsSigned
                  - alreadySigned
        '401':
          description: Missing, invalid, expired, or reissued signing link
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '404':
          description: The link's envelope or participant no longer exists
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '409':
          description: >-
            Out-of-order submission, consent missing, terminal envelope, or a
            concurrent modification
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '422':
          description: >-
            Values reference fields not assigned to this participant
            (validation_error), or required fields are incomplete
            (required_fields_missing)
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
      security:
        - signerToken: []
components:
  securitySchemes:
    signerToken:
      type: http
      scheme: bearer
      description: HMAC-signed envelope token, as a bearer token or a `token` query param.

````