> ## 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.

# Decline to sign

> Terminates the envelope (spec §5.5): appends `participant.declined` with the sanitized reason and the request's audit facts; the envelope status derives to `declined`. Allowed only when it is the signer's turn.



## OpenAPI

````yaml /openapi.json post /api/signer/decline
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/signer/decline:
    post:
      tags:
        - signer
      summary: Decline to sign
      description: >-
        Terminates the envelope (spec §5.5): appends `participant.declined` with
        the sanitized reason and the request's audit facts; the envelope status
        derives to `declined`. Allowed only when it is the signer's turn.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                reason:
                  type: string
                  maxLength: 500
      responses:
        '200':
          description: The envelope was declined
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - draft
                      - detecting
                      - review
                      - in_progress
                      - completed
                      - declined
                      - voided
                      - expired
                required:
                  - status
        '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: Not the signer's turn, or the envelope is no longer active
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '422':
          description: >-
            Malformed body or decline reason exceeds 500 characters
            (validation_error)
          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.

````