LogicGate Risk Cloud integration

GRC workflows: applications, workflows, steps, records, fields, workflow maps

Help CentreConnectors

Overview

LogicGate Risk Cloud is a configurable GRC workflow platform. The Automize connector reads the structure a tenant has built — applications, workflows, steps, fields and workflow maps — and creates, reads, updates and progresses the records that move through it.


Setting up the connection

Auth type: login_exchange.

  1. Get the environment subdomain from the Risk Cloud URL: for https://acme.logicgate.com it is acme. Sandbox tenants usually carry their own subdomain.
  2. In Risk Cloud, create an API key pair. It has two halves — a Client key and a Secret key.
  3. In Automize, open Settings → Connectors → LogicGate Risk Cloud → Add connection and paste both halves. Automize exchanges them for a short-lived bearer token on each run.
  4. Leave the optional pre-issued token blank in normal use. Risk Cloud tokens are short-lived, so a pasted one stops working and the exchange is what keeps a scheduled process running.

Available operations

18 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Create RecordGeneralCreate a record on a step, optionally with field values and an assignee. fields is a list of {fieldId, values:[...]} — every value is a STRING, including booleans and numbers.
Get ApplicationGeneralGet one application by its ID
Get RecordGeneralGet one record by its ID
Get StepGeneralGet one step by its ID
Get WorkflowGeneralGet one workflow by its ID
List Access AuditsGeneralList access-audit entries
List ApplicationsGeneralList applications the API user has Build access to
List FieldsGeneralList field definitions — the source of the fieldId values a record write needs
List Linked RecordsGeneralList the records linked to a given record
List RecordsGeneralList records the API user can read. Filter with application-id, workflow-id, step-id or updated-min (epoch milliseconds).
List StepsGeneralList steps, optionally scoped to one workflow
List Workflow MapsGeneralList workflow maps (how workflows relate to one another)
List WorkflowsGeneralList workflows, optionally scoped to one application
LoginGeneralRe-authenticate with the key pair and refresh the bearer token
Move Record (force)GeneralForce a record onto another step WITHOUT validating required fields. Use progress_record when the workflow's own validation should apply.
Progress Record (validated)GeneralAdvance a record along its workflow, honouring required-field validation. Refused if the record is incomplete — that refusal is the point.
Search Records by Field ValueGeneralFind records whose field holds a given text or numeric value (v1)
Update RecordGeneralUpdate a record's field values. The body is a bare LIST of {"fieldId": "...", "values": ["..."]} — not an object.

Operations

Create Record

Create a record on a step, optionally with field values and an assignee. fields is a list of {fieldId, values:[...]} — every value is a STRING, including booleans and numbers.

ParameterRequiredTypeDescription
Step ID stepIdYesstring
Assignee email assigneeEmailAddressNostringEmail address of the Risk Cloud user to assign the new record to.
Due date recordDueDateNostringEpoch seconds, or 'MM-DD-YY HH:MM:SS'.
Field values fieldsNolistList of {"fieldId": "...", "values": ["..."]}. Values are always strings.

Get Application

Get one application by its ID

ParameterRequiredTypeDescription
Application ID idYesstring

Get Record

Get one record by its ID

ParameterRequiredTypeDescription
Record ID idYesstring

Get Step

Get one step by its ID

ParameterRequiredTypeDescription
Step ID idYesstring

Get Workflow

Get one workflow by its ID

ParameterRequiredTypeDescription
Workflow ID idYesstring

List Access Audits

List access-audit entries

No input parameters.


List Applications

List applications the API user has Build access to

No input parameters.


List Fields

List field definitions — the source of the fieldId values a record write needs

No input parameters.


List Linked Records

List the records linked to a given record

ParameterRequiredTypeDescription
Record ID idYesstring

List Records

List records the API user can read. Filter with application-id, workflow-id, step-id or updated-min (epoch milliseconds).

ParameterRequiredTypeDescription
Application ID application-idNostring
Workflow ID workflow-idNostring
Step ID step-idNostring
Updated since (epoch ms) updated-minNostringMilliseconds since the Unix epoch. Only records modified after this are returned.

List Steps

List steps, optionally scoped to one workflow

No input parameters.


List Workflow Maps

List workflow maps (how workflows relate to one another)

No input parameters.


List Workflows

List workflows, optionally scoped to one application

No input parameters.


Login

Re-authenticate with the key pair and refresh the bearer token

ParameterRequiredTypeDescription
Client key client_keyNostring
Secret key secret_keyNopassword

Move Record (force)

Force a record onto another step WITHOUT validating required fields. Use progress_record when the workflow's own validation should apply.

ParameterRequiredTypeDescription
Record ID record-idYesstring
Target step ID step-idYesstring

Progress Record (validated)

Advance a record along its workflow, honouring required-field validation. Refused if the record is incomplete — that refusal is the point.

ParameterRequiredTypeDescription
Workflow ID workflowIdYesstring
Target step ID stepIdYesstring
Record ID record-idYesstring
Application ID application-idYesstring
Assignee user ID userIdNostringRisk Cloud user id to assign the record to on arrival. Left unset, the step's own assignment rules apply.
Target step type stepTypeNostring

Search Records by Field Value

Find records whose field holds a given text or numeric value (v1)

ParameterRequiredTypeDescription
Field ID fieldYesstring
Text value textValueNostring
Numeric value numericValueNonumber

Update Record

Update a record's field values. The body is a bare LIST of {"fieldId": "...", "values": ["..."]} — not an object.

ParameterRequiredTypeDescription
Record ID record-idYesstring
Field values fieldsYeslistList of {"fieldId": "...", "values": ["..."]}. Values are always strings.

FAQ

What is the difference between Move Record and Progress Record?
Progress Record (validated) advances a record the way the UI does — Risk Cloud runs the step's validation first and refuses the move if the record does not satisfy it. Move Record (force) puts the record on a step regardless. Prefer the validated one; reach for force only when deliberately repairing a stuck record.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.