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

# Prepare frozen signing preview

> Memerlukan scope packages:create. Hanya sandbox; allowlist aplikasi dan kewenangan pemohon juga diperiksa.



## OpenAPI

````yaml /openapi-id.json post /api/v1/signature-packages/preview
openapi: 3.0.3
info:
  title: API sandbox dan sesi DekaSign
  version: '2026-10-18'
  description: >-
    Endpoint manajemen hanya untuk sandbox dan dapat mengembalikan
    SANDBOX_API_DISABLED pada host produksi. Desain template dan keputusan
    manusia bukan API machine-key. Rute sesi memakai autentikasi terpisah.
    Respons dapat diperluas; panduan menjelaskan field penting. Spesifikasi ini
    tidak memberikan akses atau mengaktifkan fitur.
servers:
  - url: https://{workspace}.dekasign.com
    description: Gunakan workspace sandbox berwenang yang diberikan administrator.
    variables:
      workspace:
        default: your-workspace
security: []
paths:
  /api/v1/signature-packages/preview:
    post:
      tags:
        - signature-packages
      summary: Prepare frozen signing preview
      description: >-
        Memerlukan scope packages:create. Hanya sandbox; allowlist aplikasi dan
        kewenangan pemohon juga diperiksa.
      operationId: post_signature_packages_preview
      parameters:
        - name: X-Dekasign-Environment
          in: header
          required: true
          schema:
            type: string
            enum:
              - sandbox
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                template_id:
                  type: string
                expires_in_days:
                  type: integer
                  minimum: 1
                  maximum: 365
                sender_values:
                  type: object
                  additionalProperties:
                    oneOf:
                      - type: string
                        maxLength: 4000
                      - type: number
                      - type: boolean
                signers:
                  type: array
                  minItems: 1
                  maxItems: 20
                  items:
                    type: object
                    properties:
                      slot_id:
                        type: string
                      name:
                        type: string
                        minLength: 2
                        maxLength: 100
                      email:
                        type: string
                        format: email
                      phone:
                        type: string
                        maxLength: 30
                      recipient_kind:
                        type: string
                        enum:
                          - internal
                          - external
                    required:
                      - slot_id
                      - name
                      - email
                    additionalProperties: false
              required:
                - template_id
                - expires_in_days
                - signers
              additionalProperties: false
      responses:
        '200':
          description: >-
            Hasil operasi. Field respons berbeda menurut endpoint dan
            deployment; lihat panduan.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preview_token:
                    type: string
                    description: >-
                      Receipt rahasia yang dibekukan; berlaku 10 menit. Jangan
                      dicatat ke log.
                  template_id:
                    type: string
                  template_name:
                    type: string
                  template_version:
                    type: integer
                  expires_at:
                    type: string
                    format: date-time
                  preview_valid_until:
                    type: string
                    format: date-time
                  signers:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  fields:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  pdf_url:
                    type: string
                  pdf_url_is_source:
                    type: boolean
                    enum:
                      - true
                  prepared_pdf:
                    type: object
                    properties:
                      url:
                        type: string
                      method:
                        type: string
                        enum:
                          - POST
                      body:
                        type: object
                        properties:
                          template_id:
                            type: string
                          preview_token:
                            type: string
                        required:
                          - template_id
                          - preview_token
                        additionalProperties: false
                    required:
                      - url
                      - method
                      - body
                    additionalProperties: false
                  notice:
                    type: string
                additionalProperties: true
        '400':
          description: Operasi atau layout tidak valid.
        '401':
          description: Kredensial/sesi tidak valid atau kedaluwarsa.
        '403':
          description: Scope, environment, tenant atau kewenangan ditolak.
        '404':
          description: Tidak ditemukan atau di luar lingkup aplikasi.
        '409':
          description: Versi kedaluwarsa, masih digunakan aktif atau konflik idempotensi.
        '422':
          description: Schema atau idempotency key wajib tidak valid.
        '429':
          description: Batas laju permintaan tercapai.
        '503':
          description: Sandbox tidak aktif atau operasi sementara tidak tersedia.
      security:
        - SandboxBearer: []
components:
  securitySchemes:
    SandboxBearer:
      type: http
      scheme: bearer
      description: Key sandbox dks_test_, hanya untuk server.

````

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