Strise Connect API Docs

Custom risk fields let you define and manage your own risk classification criteria on entities. This guide covers listing available fields with their options and programmatically updating field values on entities.

List available custom risk fields

Use the customRiskFields query to retrieve all custom risk field definitions configured for your team, including their available options:

query ListCustomRiskFields {
  customRiskFields {
    id
    name
    kind
    options {
      id
      name
    }
  }
}

This returns all fields with their id, name, kind (SINGLE_SELECT or MULTI_SELECT), and the list of selectable options. Each option has its own id and name.

Example response

{
  "data": {
    "customRiskFields": [
      {
        "id": "crf_abc123",
        "name": "Industry Risk",
        "kind": "SINGLE_SELECT",
        "options": [
          { "id": "opt_low", "name": "Low" },
          { "id": "opt_medium", "name": "Medium" },
          { "id": "opt_high", "name": "High" }
        ]
      },
      {
        "id": "crf_def456",
        "name": "Red Flags",
        "kind": "MULTI_SELECT",
        "options": [
          { "id": "opt_shell", "name": "Shell company" },
          { "id": "opt_offshore", "name": "Offshore structure" },
          { "id": "opt_cash", "name": "Cash-intensive business" }
        ]
      }
    ]
  }
}

Build a mapping from internal data points

To automate updates, create a mapping from your internal data points to the Strise custom risk field IDs and option IDs. Fetch the fields once, then use the IDs when updating entities.

For example, if your internal system classifies industry risk as "high", map it to the corresponding option ID:

Internal value "high" → Custom risk field "crf_abc123", option "opt_high"
Internal value "medium" → Custom risk field "crf_abc123", option "opt_medium"

For MULTI_SELECT fields, map to multiple option IDs:

Internal flags ["shell_company", "offshore"] → Custom risk field "crf_def456", options ["opt_shell", "opt_offshore"]

Update a custom risk field on an entity

Use the entityUpdateCustomRiskField mutation to set the selected options for a custom risk field on a company or private person:

mutation UpdateCustomRiskField {
  entityUpdateCustomRiskField(
    where: {
      id: "<entity_id>"
      riskFieldId: "<custom_risk_field_id>"
      selectedOptionIds: ["<option_id_1>", "<option_id_2>"]
    }
  ) {
    riskField {
      id
      name
    }
    selectedOptions {
      id
      name
    }
  }
}

The mutation returns all custom risk fields on the entity with their current values.

Single-select field

For a SINGLE_SELECT field, pass exactly one option ID:

mutation SetIndustryRisk {
  entityUpdateCustomRiskField(
    where: {
      id: "<company_id>"
      riskFieldId: "crf_abc123"
      selectedOptionIds: ["opt_high"]
    }
  ) {
    riskField {
      id
      name
    }
    selectedOptions {
      id
      name
    }
  }
}

Multi-select field

For a MULTI_SELECT field, pass one or more option IDs:

mutation SetRedFlags {
  entityUpdateCustomRiskField(
    where: {
      id: "<company_id>"
      riskFieldId: "crf_def456"
      selectedOptionIds: ["opt_shell", "opt_offshore"]
    }
  ) {
    riskField {
      id
      name
    }
    selectedOptions {
      id
      name
    }
  }
}

Clear a custom risk field

To remove all selected options from a field, pass an empty list:

mutation ClearCustomRiskField {
  entityUpdateCustomRiskField(
    where: {
      id: "<company_id>"
      riskFieldId: "crf_abc123"
      selectedOptionIds: []
    }
  ) {
    riskField {
      id
      name
    }
    selectedOptions {
      id
      name
    }
  }
}

Custom Risk Fields