> ## 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 > أعِد فتح عدة حالات أو اطلب معلومات بشأنها أو حلّها في استدعاء واحد عبر Didit، مع الإبلاغ عن إخفاقات بوابات كل حالة دون إيقاف الدفعة. موجه واجهة API لتحديث حالة الحالات بالجملة نسخ الموجّه إلى الحافظة \

\`Update the status of several cases in one call through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/bulk/status/

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

Request body:
\{
"case_uuids": ["", ""],   // required, at least 1
"status": "RESOLVED",                   // required: OPEN | AWAITING_USER | RESOLVED
"resolution": "FALSE_POSITIVE",         // required when status is RESOLVED
"note": "Bulk-cleared after review"      // optional
}

Behavior:
\- OPEN reopens each case, AWAITING_USER requests info, RESOLVED resolves with the given resolution/note.
\- Each case is evaluated independently inside its own transaction - a case blocked by an incomplete checklist or a missing required note is reported in "failures" without aborting the rest of the batch.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/bulk/status/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"case_uuids": [""], "status": "RESOLVED", "resolution": "FALSE_POSITIVE"}'

Response 200: {"updated": 3, "failures": [{"case_uuid": "", "detail": "Case has incomplete checklist items: ..."}]}

Failure modes:
\- 400 - status is RESOLVED without a resolution, or case_uuids is empty.
\- 401/403 - auth/permission errors.

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

\
الصق في طبّق انتقال الحالة نفسه على عدد كبير من الحالات دفعة واحدة، بما يطابق إجراء **Set Status** الجماعي في قائمة الحالات. يُبلَّغ عن الإخفاقات لكل حالة على حدة، لذا لا تؤدي حالة واحدة محظورة أبداً إلى التراجع عن بقية الدفعة.## ذات صلة- [حل الحالة](https://docs.didit.me/ar/management-api/cases/resolve.md) - [سرد الحالات](https://docs.didit.me/ar/management-api/cases/list.md) ## OpenAPI ````yaml ar/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/bulk/status/ 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/bulk/status/: post: tags: - Cases summary: تحديث مجمّع لحالة الحالة description: >- تطبيق نفس انتقال الحالة على عدة حالات في استدعاء واحد: يقوم OPEN بإعادة الفتح، ويطلب AWAITING_USER معلومات، ويحل RESOLVED الحالة (الحل مطلوب). يتم تقييم كل حالة بشكل مستقل؛ ويتم الإبلاغ عن إخفاقات بوابات التحقق (قائمة تحقق غير مكتملة، ملاحظة مطلوبة مفقودة) لكل حالة دون إيقاف الدفعة. operationId: bulk_update_case_status 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: true content: application/json: schema: type: object required: - case_uuids - status properties: case_uuids: type: array items: type: string format: uuid minItems: 1 status: type: string enum: - OPEN - AWAITING_USER - RESOLVED resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED description: مطلوب عندما تكون الحالة RESOLVED. note: type: string nullable: true example: case_uuids: - c1a5e000-0000-4000-8000-000000000001 status: RESOLVED resolution: FALSE_POSITIVE responses: '200': description: النتائج لكل حالة. content: application/json: schema: $ref: '#/components/schemas/CaseBulkUpdateResult' 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/bulk/status/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"case_uuids": ["c1a5e000-0000-4000-8000-000000000001"], "status": "RESOLVED", "resolution": "FALSE_POSITIVE"}' - 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.bulk_update_status( case_uuids=["c1a5e000-0000-4000-8000-000000000001"], status="RESOLVED", resolution="FALSE_POSITIVE", ) 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.bulkUpdateStatus({ case_uuids: ["c1a5e000-0000-4000-8000-000000000001"], status: "RESOLVED", resolution: "FALSE_POSITIVE", }); 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.BulkUpdateStatus(ctx, didit.CasesBulkUpdateStatusParams{\n\tCaseUUIDs: []string{\"c1a5e000-0000-4000-8000-000000000001\"},\n\tStatus: \"RESOLVED\",\n\tResolution: didit.Some(didit.CasesBulkUpdateStatusParamsResolution(\"FALSE_POSITIVE\")),\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.CasesBulkUpdateStatusParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().bulkUpdateStatus(CasesBulkUpdateStatusParams.builder() .caseUuids(List.of("c1a5e000-0000-4000-8000-000000000001")) .status(CasesBulkUpdateStatusParams.Status.of("RESOLVED")) .resolution(CasesBulkUpdateStatusParams.Resolution.of("FALSE_POSITIVE")) .build()); System.out.println(result); - lang: php label: PHP source: |- cases->bulkUpdateStatus([ 'case_uuids' => ['c1a5e000-0000-4000-8000-000000000001'], 'status' => 'RESOLVED', 'resolution' => 'FALSE_POSITIVE', ]); 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.bulk_update_status( case_uuids: ["c1a5e000-0000-4000-8000-000000000001"], status: "RESOLVED", resolution: "FALSE_POSITIVE" ) 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.BulkUpdateStatusAsync(new CasesBulkUpdateStatusParams { CaseUuids = new string[] { "c1a5e000-0000-4000-8000-000000000001" }, Status = "RESOLVED", Resolution = new CasesBulkUpdateStatusParamsResolution("FALSE_POSITIVE"), }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseBulkUpdateResult: type: object properties: updated: type: integer failures: type: array items: type: object properties: case_uuid: type: string format: uuid detail: 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.