Overview
Diligent HighBond (Diligent One) is an audit, risk and compliance platform. The Automize connector reads the audit workspace — projects, objectives, controls, control tests, walkthroughs, risks, issues, frameworks, entities and request items — creates and updates issues, and runs Robot tasks.
Setting up the connection
Auth type: Bearer Token.
- In Launchpad, open your profile → Manage API tokens and create a token. It is shown once, at creation.
- Note the region your Diligent One instance is provisioned in. A request sent to the wrong region host fails rather than redirecting, so this has to be right.
- Get the numeric organization ID from Launchpad → Options → Organization.
- In Automize, open Settings → Connectors → Diligent HighBond → Add connection and fill in the token, region and organization ID.
Available operations
39 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Issue | General | Raise an issue on a project. Pass the fields flat (title, description, severity...) — they are wrapped in the JSON:API envelope for you. |
| Get Control | General | Get one control by its ID |
| Get Issue | General | Get one issue by its ID |
| Get Objective | General | Get one objective by its ID |
| Get Project | General | Get one project by its ID |
| Get Risk | General | Get one risk by its ID |
| List Analyses | General | List the analyses in a Results collection |
| List Analysis Tables | General | List the tables of one analysis |
| List Collections | General | List Results collections |
| List Compliance Regulations | General | List compliance regulations |
| List Compliance Requirements | General | List the requirements of one compliance regulation |
| List Control Test Plans | General | List control test plans |
| List Control Tests | General | List control tests and their results |
| List Controls | General | List controls across the organisation |
| List Entities | General | List entities (the org units audit work is scoped to) |
| List Entity Categories | General | List entity categories |
| List Frameworks | General | List compliance frameworks |
| List Groups | General | List user groups. ⚠️ Rate-limited to 3 requests per MINUTE |
| List Issue Actions | General | List the remediation actions attached to an issue |
| List Issues | General | List issues across the organisation |
| List Mitigations | General | List mitigations |
| List Objective Controls | General | List the controls mitigating an objective's risks |
| List Objective Risks | General | List the risks recorded against an objective |
| List Project Issues | General | List the issues raised on one project |
| List Project Objectives | General | List the objectives of one project |
| List Project Request Items | General | List the request items of one project |
| List Project Types | General | List the project types configured for the organisation |
| List Projects | General | List audit projects in the organisation |
| List Request Items | General | List PBC / request items |
| List Robot Tasks | General | List the tasks of one robot |
| List Robots | General | List HighBond robots |
| List Strategy Objectives | General | List strategy objectives |
| List Strategy Risks | General | List enterprise (strategy) risks |
| List Table Records | General | List the records held in a Results table |
| List Time Entries | General | List time entries logged against projects |
| List Users | General | List organisation users. ⚠️ Rate-limited to 3 requests per MINUTE |
| List Walkthroughs | General | List control walkthroughs |
| Run Robot Task | General | Trigger a robot task immediately |
| Update Issue | General | Update an existing issue's fields |
Operations
Create Issue
Raise an issue on a project. Pass the fields flat (title, description, severity...) — they are wrapped in the JSON:API envelope for you.
| Parameter | Required | Type | Description |
|---|---|---|---|
Project ID project_id | Yes | string | |
Title title | No | string | |
Description description | No | text | |
Attributes (raw) attributes | No | object |
Get Control
Get one control by its ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Control ID id | Yes | string |
Get Issue
Get one issue by its ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Issue ID id | Yes | string |
Get Objective
Get one objective by its ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Objective ID id | Yes | string |
Get Project
Get one project by its ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Project ID id | Yes | string |
Get Risk
Get one risk by its ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Risk ID id | Yes | string |
List Analyses
List the analyses in a Results collection
| Parameter | Required | Type | Description |
|---|---|---|---|
Collection ID collection_id | Yes | string |
List Analysis Tables
List the tables of one analysis
| Parameter | Required | Type | Description |
|---|---|---|---|
Analysis ID analysis_id | Yes | string |
List Collections
List Results collections
No input parameters.
List Compliance Regulations
List compliance regulations
No input parameters.
List Compliance Requirements
List the requirements of one compliance regulation
| Parameter | Required | Type | Description |
|---|---|---|---|
Regulation ID compliance_regulation_id | Yes | string |
List Control Test Plans
List control test plans
No input parameters.
List Control Tests
List control tests and their results
No input parameters.
List Controls
List controls across the organisation
No input parameters.
List Entities
List entities (the org units audit work is scoped to)
No input parameters.
List Entity Categories
List entity categories
No input parameters.
List Frameworks
List compliance frameworks
No input parameters.
List Groups
List user groups. ⚠️ Rate-limited to 3 requests per MINUTE
No input parameters.
List Issue Actions
List the remediation actions attached to an issue
| Parameter | Required | Type | Description |
|---|---|---|---|
Issue ID issue_id | Yes | string |
List Issues
List issues across the organisation
No input parameters.
List Mitigations
List mitigations
No input parameters.
List Objective Controls
List the controls mitigating an objective's risks
| Parameter | Required | Type | Description |
|---|---|---|---|
Objective ID objective_id | Yes | string |
List Objective Risks
List the risks recorded against an objective
| Parameter | Required | Type | Description |
|---|---|---|---|
Objective ID objective_id | Yes | string |
List Project Issues
List the issues raised on one project
| Parameter | Required | Type | Description |
|---|---|---|---|
Project ID project_id | Yes | string |
List Project Objectives
List the objectives of one project
| Parameter | Required | Type | Description |
|---|---|---|---|
Project ID parent_resource_id | Yes | string |
List Project Request Items
List the request items of one project
| Parameter | Required | Type | Description |
|---|---|---|---|
Project ID project_id | Yes | string |
List Project Types
List the project types configured for the organisation
No input parameters.
List Projects
List audit projects in the organisation
No input parameters.
List Request Items
List PBC / request items
No input parameters.
List Robot Tasks
List the tasks of one robot
| Parameter | Required | Type | Description |
|---|---|---|---|
Robot ID robot_id | Yes | string |
List Robots
List HighBond robots
No input parameters.
List Strategy Objectives
List strategy objectives
No input parameters.
List Strategy Risks
List enterprise (strategy) risks
No input parameters.
List Table Records
List the records held in a Results table
| Parameter | Required | Type | Description |
|---|---|---|---|
Table ID table_id | Yes | string |
List Time Entries
List time entries logged against projects
No input parameters.
List Users
List organisation users. ⚠️ Rate-limited to 3 requests per MINUTE
No input parameters.
List Walkthroughs
List control walkthroughs
No input parameters.
Run Robot Task
Trigger a robot task immediately
| Parameter | Required | Type | Description |
|---|---|---|---|
Robot task ID id | Yes | string |
Update Issue
Update an existing issue's fields
| Parameter | Required | Type | Description |
|---|---|---|---|
Issue ID id | Yes | string | |
Title title | No | string | |
Description description | No | text | |
Attributes (raw) attributes | No | object |
FAQ
- Which region do I choose?
- The one your instance was provisioned in — it is part of the Launchpad URL you sign in at. The connector talks to that region's API host directly; a mismatched region returns an error instead of following a redirect, so a connection that authenticates in one region will not quietly work in another.
- Can a process run an analytic?
- It can run a Robot task (Run Robot Task) and read the results back with List Robot Tasks and List Table Records.