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

# Create hosted editor session

> Memerlukan scope documents:write. Hanya sandbox; allowlist aplikasi dan kewenangan pemohon juga diperiksa.



## OpenAPI

````yaml /openapi-id.json post /api/v1/documents/{id}/session
openapi: 3.0.3
info:
  title: DekaSign integration and session API
  version: '2026-10-28'
  description: >-
    API Production memerlukan paket berbayar aktif, key/aplikasi Production,
    cakupan dan kapabilitas yang diizinkan. Operasi manajemen desain tertentu
    hanya untuk sandbox. Desain template dan keputusan approval manusia tidak
    diambil alih API key. Rute sesi memakai identitas terpisah. Spesifikasi ini
    tidak memberikan akses atau mengaktifkan kapabilitas.
servers:
  - url: https://{workspace}.dekasign.com
    description: Gunakan workspace organisasi yang diizinkan untuk aplikasi integrasi Anda.
    variables:
      workspace:
        default: your-workspace
security: []
paths:
  /api/v1/documents/{id}/session:
    post:
      tags:
        - documents
      summary: Create hosted editor session
      description: >-
        Memerlukan scope documents:write. Hanya sandbox; allowlist aplikasi dan
        kewenangan pemohon juga diperiksa.
      operationId: post_documents_id_session
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Identitas dalam lingkup workspace.
        - name: X-Dekasign-Environment
          in: header
          required: true
          schema:
            type: string
            enum:
              - sandbox
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                purpose:
                  type: string
                  minLength: 3
                  maxLength: 120
                  default: Prepare Instance
                expires_in_seconds:
                  type: integer
                  minimum: 60
                  maximum: 86400
                  default: 3600
              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:
        - 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.