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

# تثبيت قوالب الحالات الجاهزة API

> ثبّت قوالب الحالات المدمجة لفحص الطلبات المطابقة، والتحقيق في AML، والنشاط المشبوه، ومراجعة KYC كقوالب قابلة للتعديل في Didit.



موجّه واجهة برمجة تطبيقات تثبيت القوالب المُعدّة مسبقًا
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\`Install built-in blueprint presets through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/blueprints/presets/install/

Authentication:
Use the x-api-key header with my Didit API key.

Request body:
\{"preset_keys": ["aml_investigation", "kyc"]}   // optional - omit to install every preset not yet installed

Valid preset_keys: screening_hit, aml_investigation, suspicious_activity, kyc.

Behavior:
\- Idempotent per preset_key - re-installing an already-installed preset is skipped, not duplicated.
\- Installed presets become fully independent, editable CaseBlueprint rows; further edits do not affect the catalogue or other applications.
\- None of the presets set assignment_method, assignee_pool, escalation, transfer, or 4-eyes - those routing decisions are always yours to configure after installing.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/blueprints/presets/install/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"preset_keys": ["aml_investigation", "kyc"]}'

Response 201 (or 200 if nothing new was installed): {"created": ["aml_investigation", "kyc"]}

Failure modes:
\- 401/403 - auth/permission errors (requires write:cases).

For the full integration shape, see /integration/integration-prompt.`

\</pre>



      
      

الصق في

انسخ قالبًا مُعدًّا مسبقًا أو أكثر إلى التطبيق بوصفها قوالبَ قابلةً للتحرير. استدعِ `GET .../cases/blueprints/presets/` أولًا لعرض الكتالوج الكامل والقوالب المثبتة بالفعل.## ذات صلة- [إنشاء قالب حالة](https://docs.didit.me/ar/management-api/case-blueprints/create.md)
- [القوالب (وحدة التحكم)](https://docs.didit.me/ar/console/case-management/blueprints.md)


## OpenAPI

````yaml ar/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/presets/install/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/presets/install/:
    post:
      tags:
        - Case Blueprints
      summary: تثبيت الإعدادات المسبقة للمخطط
      description: >-
        انسخ إعداداً مسبقاً واحداً أو أكثر إلى التطبيق كمخططات قابلة للتعديل.
        تتسم العملية بخاصية idempotency لكل preset_key؛ أغفل preset_keys لتثبيت
        كل إعداد مسبق لم يتم تثبيته بعد.
      operationId: install_case_blueprint_presets
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID الخاص بالمؤسسة.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: معرّف UUID للتطبيق.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                preset_keys:
                  type: array
                  items:
                    type: string
                  nullable: true
                  description: >-
                    مجموعة فرعية من screening_hit، وaml_investigation،
                    وsuspicious_activity، وkyc. احذفه لتثبيت الكل.
            example:
              preset_keys:
                - aml_investigation
                - kyc
      responses:
        '200':
          description: >-
            لا توجد إعدادات مسبقة جديدة لتثبيتها (جميع الإعدادات المسبقة
            المطلوبة موجودة بالفعل).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseBlueprintPresetInstallResult'
        '201':
          description: إعداد مسبق واحد أو أكثر تم تثبيته.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseBlueprintPresetInstallResult'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/blueprints/presets/install/'
            \
              -H 'x-api-key: YOUR_API_KEY' \
              -H 'Content-Type: application/json' \
              -d '{"preset_keys": ["aml_investigation", "kyc"]}'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            client = Didit()

            result = client.cases.blueprints.install_presets(
                preset_keys=["aml_investigation", "kyc"],
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            const didit = new Didit();

            const result = await didit.cases.blueprints.installPresets({
              preset_keys: ["aml_investigation", "kyc"],
            });
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.Blueprints.InstallPresets(ctx, didit.CasesBlueprintsInstallPresetsParams{\n\tPresetKeys: didit.Some([]string{\"aml_investigation\", \"kyc\"}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import java.util.List;

            import me.didit.Didit;

            import me.didit.types.CasesBlueprintsInstallPresetsParams;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            Didit client = new Didit();


            var result =
            client.cases().blueprints().installPresets(CasesBlueprintsInstallPresetsParams.builder()
                    .presetKeys(List.of("aml_investigation", "kyc"))
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            $result = $didit->cases->blueprints->installPresets([
                'preset_keys' => ['aml_investigation', 'kyc'],
            ]);
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            # and DIDIT_APPLICATION_ID.

            didit = Didit::Client.new


            result = didit.cases.blueprints.install_presets(preset_keys:
            ["aml_investigation", "kyc"])

            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            using var client = new DiditClient();


            var result = await client.Cases.Blueprints.InstallPresetsAsync(new
            CasesBlueprintsInstallPresetsParams

            {
                PresetKeys = new string[] { "aml_investigation", "kyc" },
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    CaseBlueprintPresetInstallResult:
      type: object
      properties:
        created:
          type: array
          items:
            type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console.
        يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا
        شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات
        المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن
        المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم
        إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو
        الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير
        404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة
        بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL
        للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك
        إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع
        https://docs.didit.me/console/api-keys.

````

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