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

# Request or verify recipient OTP

> Bukan endpoint integration-key. Memerlukan alur sesi/identitas khusus sesuai panduan.



## OpenAPI

````yaml /openapi-id.json post /api/v1/guest/auth
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/guest/auth:
    post:
      tags:
        - guest
      summary: Request or verify recipient OTP
      description: >-
        Bukan endpoint integration-key. Memerlukan alur sesi/identitas khusus
        sesuai panduan.
      operationId: post_guest_auth
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    action:
                      type: string
                      enum:
                        - request_otp
                    email:
                      type: string
                      format: email
                    requestId:
                      type: string
                  required:
                    - action
                    - email
                    - requestId
                  additionalProperties: false
                - type: object
                  properties:
                    action:
                      type: string
                      enum:
                        - verify_otp
                    email:
                      type: string
                      format: email
                    requestId:
                      type: string
                    code:
                      type: string
                      pattern: ^[0-9]{6}$
                  required:
                    - action
                    - email
                    - requestId
                    - code
                  additionalProperties: false
      responses:
        '200':
          description: >-
            Hasil operasi. Field respons berbeda menurut endpoint dan
            deployment; lihat panduan.
          content:
            application/json:
              schema:
                type: object
                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: []

````

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