Investigations

Update Investigation Evidences

Changed on

Updates the Investigation with Evidences.

patch/investigations/{investigation_token}/evidences

Request

Path parameters

investigation_tokenstring required

Token associated with the Investigation

Request body

notestring

Example request

{
  "note": "Investigation note",
  "journey_alerts": [
    {
      "agent_token": "AG-L83m6iTwcXdNg3CHndS4",
      "journey_alert_token": "JA-LS0GHKjDNhY6dGlvYxx",
      "outcome": "Dismissed",
      "reason": "Passed manual checks",
      "note": "My note"
    }
  ]
}

Response

Success

alerts_addedstring[]
alerts_presentstring[]

Example response

{
  "investigation": {
    "investigation_token": "INV-EAx2xoAsqF1ibKTQzkXV",
    "closed_at": "2024-12-05T20:05:43.643Z",
    "created_at": "2024-11-26T16:00:14.677Z",
    "type": "Fraud",
    "state": "case_review",
    "source": "alert",
    "outcome": "Dismissed",
    "updated_at": "2024-12-05T20:05:43.643Z",
    "archived_at": "2024-12-05T20:05:43.643Z",
    "_embedded": {
      "assigned_agent": {
        "first_name": "Mike",
        "last_name": "Alloy",
        "email": "safeandseamless@alloy.com",
        "token": "AG-L83m6iTwcXdNg3CHndS4"
      },
      "entities": {
        "P-KaKZxdSGnbxXfKXnXdyp": {
          "type": "person",
          "entity_token": "P-KaKZxdSGnbxXfKXnXdyp",
          "entity_name": "Trycia Turner",
          "external_entity_identifier": "mjj09291-111824-3"
        }
      },
      "events": [
        {
          "event": "closed",
          "agent": {
            "first_name": "Mike",
            "last_name": "Alloy",
            "email": "safeandseamless@alloy.com",
            "token": "AG-L83m6iTwcXdNg3CHndS4"
          }
        }
      ],
      "evidences": {
        "journey_alerts": [
          {
            "journey_application_token": "JA-PA0M5o6nyYCGhVyhXYWH",
            "journey_token": "J-O9aI8AWpkv895oavftOH"
          }
        ],
        "tags": [
          {
            "tag_color": "FB923C",
            "tag_name": "Phone Reputation Fail",
            "is_outcome_reason": true,
            "added_by": {
              "email": "agent@email.com",
              "first_name": "Mike",
              "last_name": "Alloy",
              "token": "AG-L83m6iTwcXdNg3CHndS4"
            }
          }
        ]
      },
      "notes": [
        {
          "created_at": "2025-01-01T13:00:59.000Z",
          "created_by": {
            "first_name": "Mike",
            "last_name": "Alloy",
            "email": "agent@email.com",
            "token": "AG-f5NJW4vCmoxwxkn4BpOV"
          },
          "entity_name": "Nick Armstrong",
          "entity_token": "P-KaKZxdSGnbxXfKXnXdyp",
          "text": "My note",
          "is_investigation_level_note": true
        }
      ],
      "reviews": [
        {
          "new_investigation_state": "alert_review_closed",
          "outcome": "Dismissed",
          "previous_investigation_state": "alert_review",
          "reason": "Verified by human",
          "reviewed_at": "2024-12-05T20:05:43.643Z",
          "reviewed_by": {
            "first_name": "Mike",
            "last_name": "Alloy",
            "email": "safeandseamless@alloy.com",
            "token": "AG-L83m6iTwcXdNg3CHndS4"
          }
        }
      ]
    }
  },
  "alerts_added": [
    "JA-LS0GHKjDNhY6dGlvYxx"
  ],
  "alerts_present": [
    "JA-PA0M5o6nyYCGhVyhXYWH"
  ]
}

Changes

    • breaking

      added the new required request property //

    • breaking

      added the new required request property //

    • breaking

      the / request property type changed from string to object

    • breaking

      the response's property type changed from no type to object for status

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added to the response body allOf list for the response status

    • info

      added to the response body allOf list for the response status

    • info

      added to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status