Reviews

Find accounts that need a review

Open a review

POST /v1/workspaces/tnt_01JA2Z8K6Q4V7W9XBCDEFGHJKM/reviews/live
Content-Type: application/json

{"account_id":"acct_7f3a9c","priority":"high","assignee":"usr_customer_admin"}

• Send account_id. The account must have a retained assessment in this environment. Otherwise the answer is 404.
• priority is low, normal, high or urgent. The default is normal.
• assignee is optional. It must be the external user id of an active member who can read reviews in this environment.

Read the review

List reviews

import { NoResponse } from "@noresponse/node";
import { reviewsList } from "@noresponse/node/funcs/reviews-list.js";

const nr = new NoResponse({ apiKey: process.env.NORESPONSE_API_KEY! });
const pages = await reviewsList(nr.core, {
  workspaceId: "tnt_01JA2Z8K6Q4V7W9XBCDEFGHJKM",
  environment: "live",
  status: "open",
  unassigned: true,
});
for await (const page of pages) {
  if (!page.ok) throw page.error;
  for (const review of page.value.result.items) {
    console.log(review.id, review.accountId, review.priority);
  }
}

import os
from noresponse import NoResponse

with NoResponse(api_key=os.environ["NORESPONSE_API_KEY"]) as nr:
    page = nr.reviews.list(
        workspace_id="tnt_01JA2Z8K6Q4V7W9XBCDEFGHJKM",
        environment="live",
        status="open",
        unassigned=True,
    )
    while page is not None:
        for review in page.result.items:
            print(review.id, review.account_id, review.priority)
        page = page.next()

Change a review

{
  "expected_version": 1,
  "status": "in_progress",
  "priority": "urgent",
  "assignee": "usr_customer_admin"
}

• status accepts open or in_progress. Use the resolve operation to resolve a review.
• assignee: null unassigns the review.
• A status change on a resolved review reopens it. The review then has no current resolution. Its resolution history stays.

Add comments

{
  "expected_version": 2,
  "body": "Same card fingerprint as two blocked accounts."
}

Link evidence

• account: a retained account.
• assessment: an exact assessment revision. Send assessment_id and assessment_version.
• issued_credential: a key association from Associate keys issued by your platform. Send credential_id.

{
  "expected_version": 3,
  "kind": "assessment",
  "account_id": "acct_7f3a9c",
  "assessment_id": "asm_01JA2Z8K6Q4V7W9XBCDEFGHJKM",
  "assessment_version": 2,
  "reason": "First login from the shared device."
}

Resolve a review

{
  "expected_version": 4,
  "expected_risk_version": 7,
  "conclusion": "abuse",
  "note": "Confirmed token resale with two linked accounts."
}

• expected_risk_version is the account’s current_risk_version that your team reviewed.
• conclusion is benign, abuse or inconclusive.
• Send a note of 1 to 2,000 characters.

• The review version or the account risk version changed.
• The review is already resolved.
• The account inputs changed and the decision is not current.
• NoResponse did not capture the decision at that risk version.

Read resolution history

Save review views

import { reviewsCreateView } from "@noresponse/node/funcs/reviews-create-view.js";

const view = await reviewsCreateView(nr.core, {
  workspaceId: "tnt_01JA2Z8K6Q4V7W9XBCDEFGHJKM",
  environment: "live",
  body: {
    name: "Urgent and unassigned",
    shared: true,
    filter: { status: "open", priority: "urgent", unassigned: true },
  },
});
if (!view.ok) throw view.error;
console.log(view.value.result.id);

view = nr.reviews.create_view(
    workspace_id="tnt_01JA2Z8K6Q4V7W9XBCDEFGHJKM",
    environment="live",
    name="Urgent and unassigned",
    shared=True,
    filter_={"status": "open", "priority": "urgent", "unassigned": True},
)
print(view.result.id)

• A private view (shared: false) is visible only to its owner.
• A shared view is visible to everyone with review access in the environment.
• Only the owner can change or delete a view. A change or delete of a view that you do not own answers 404 not_found. owner_type is user for a member or api_key for an API key. owner_principal_id is the permanent id of that member or key.
• NoResponse saves an assignee filter as the member’s assignee_principal_id.
• name has 1 to 100 characters.

Export a review

Related pages