> ## 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. # Crea nota del caso API > Endpoint API di Didit per pubblicare una nota in testo semplice su un caso, con menzioni, tag e allegati file facoltativi. Prompt API: crea una nota del caso Copia il prompt negli appunti \

\`Post a note to a case through the Management API.

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

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

Request body:
\{
"comment": "Called the customer, awaiting a reply.",  // required
"mentioned_emails": ["teammate@company.com"],           // optional
"is_internal": false,                                    // optional, default false
"attachments": [{"s3_key": "case-notes//-file.pdf"}],  // optional - upload first via notes/presign/
"tags": ["follow-up"]                                     // optional
}

Behavior:
\- Each attachment's s3_key must be under this case's own case-notes/{case_uuid}/ prefix (returned by the upload endpoint) - otherwise 400.
\- Logs a NOTE_ADDED event and creates mention notifications for mentioned_emails.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/notes/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"comment": "Called the customer, awaiting a reply.", "tags": ["follow-up"]}'

Response 201: CaseNote.

Failure modes:
\- 400 - an attachment does not belong to this case.
\- 401/403 - auth/permission errors.

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

\
Incolla in Invia una nota in testo semplice. Per allegare un file, caricalo prima con `POST .../notes/presign/` e passa il valore `s3_key` restituito in `attachments`.## Correlati- [Elenca le note del caso](https://docs.didit.me/it/management-api/cases/list-notes.md) - [Recupera il caso](https://docs.didit.me/it/management-api/cases/get.md) ## OpenAPI ````yaml it/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/notes/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/notes/: post: tags: - Case Management description: >- Aggiungi una nota associata al caso. Un parametro client_reference opzionale fa sì che un nuovo tentativo senza modifiche restituisca la stessa nota senza duplicare attività o notifiche. reply_to deve identificare una nota attiva in questo caso. La risposta include un estratto limitato del genitore senza copiare tale estratto nella risposta salvata. operationId: create_case_note parameters: - in: path name: organization_id schema: type: string format: uuid required: true - in: path name: application_id schema: type: string format: uuid required: true - in: path name: case_uuid schema: type: string format: uuid required: true requestBody: content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CaseCollaborationCaseNoteCreateRequest' application/json: schema: $ref: '#/components/schemas/CaseCollaborationCaseNoteCreateRequest' example: comment: Proof of address matches the ID document. multipart/form-data: schema: $ref: '#/components/schemas/CaseCollaborationCaseNoteCreateRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/CaseCollaborationCaseNote' description: '' '201': content: application/json: schema: $ref: '#/components/schemas/CaseCollaborationCaseNote' description: '' '403': description: Il chiamante non dispone dell'autorizzazione richiesta per i casi. '404': description: Il caso o la nota non sono disponibili per questo chiamante. '409': description: >- Questo riferimento cliente è già stato utilizzato per un'altra nota o per una nota che è stata eliminata. security: - ApiKeyAuth: [] x-codeSamples: - 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.notes.create( "11111111-2222-3333-4444-555555555555", comment="Proof of address matches the ID document.", ) 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.notes.create("11111111-2222-3333-4444-555555555555", { comment: "Proof of address matches the ID document.", }); 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.Notes.Create(ctx, \"11111111-2222-3333-4444-555555555555\", didit.CaseCollaborationCaseNoteCreateRequest{\n\tComment: \"Proof of address matches the ID document.\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.CaseCollaborationCaseNoteCreateRequest; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().notes().create("11111111-2222-3333-4444-555555555555", CaseCollaborationCaseNoteCreateRequest.builder() .comment("Proof of address matches the ID document.") .build()); System.out.println(result); - lang: php label: PHP source: >- cases->notes->create('11111111-2222-3333-4444-555555555555', [ 'comment' => 'Proof of address matches the ID document.', ]); 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.notes.create( "11111111-2222-3333-4444-555555555555", comment: "Proof of address matches the ID document." ) 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.Notes.CreateAsync("11111111-2222-3333-4444-555555555555", new CaseCollaborationCaseNoteCreateRequest { Comment = "Proof of address matches the ID document.", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseCollaborationCaseNoteCreateRequest: type: object properties: comment: type: string minLength: 1 maxLength: 10000 reply_to: type: string format: uuid nullable: true client_reference: type: string format: uuid nullable: true mentioned_emails: type: array items: type: string format: email minLength: 1 is_internal: type: boolean default: false attachments: type: array items: type: object additionalProperties: {} tags: type: array items: type: string minLength: 1 required: - comment CaseCollaborationCaseNote: type: object properties: uuid: type: string format: uuid readOnly: true comment: type: string actor_email: type: string format: email nullable: true maxLength: 255 actor_name: type: string nullable: true maxLength: 255 mentioned_emails: {} is_internal: type: boolean attachments: {} tags: {} created_at: type: string format: date-time readOnly: true reply_to: allOf: - $ref: '#/components/schemas/CaseCollaborationCaseNoteReply' nullable: true readOnly: true is_pinned: type: boolean client_reference: type: string format: uuid nullable: true required: - comment - created_at - reply_to - uuid CaseCollaborationCaseNoteReply: type: object properties: uuid: type: string format: uuid actor_name: type: string nullable: true actor_email: type: string format: email nullable: true comment: type: string maxLength: 300 required: - actor_email - actor_name - comment - uuid securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.