21risk | Composio Docs

Overview

SLUG: _21RISK

Description

21RISK is a web application that simplifies working with checklists, audits, and actions, facilitating compliance and risk management processes.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to 21risk

Create an auth config

Use the dashboard to create an auth config for the 21risk toolkit. This allows you to connect multiple 21risk accounts to Composio for agents to use.

Select App

Navigate to the [ 21risk toolkit page](https://app.composio.dev/apps/ 21risk) and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 _21risk_auth_config_id = "ac_YOUR__21RISK_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     # Replace this with a method to retrieve an API key from the user.
12     # Or supply your own.
13     user_api_key = input("[!] Enter API key")
14 
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "API_KEY", "val": user_api_key}
19     )
20 
21     # API Key authentication is immediate - no redirect needed
22     print(f"Successfully connected  21risk for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, _21risk_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [ 21risk toolkit’s playground](https://app.composio.dev/app/ 21risk)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["_21RISK"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

_21RISK_GET_ITEMS

Tool Name: Get Items (BETA)

Description

Tool to retrieve items (beta) from the 21risk odata api. use when you need a filtered and paged list of items for analytics and reporting. example: get items($filter="item cost gt 100", $top=50).

Action Parameters

$expand

string

$filter

string

$orderby

string

$select

string

$skip

integer

$top

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_ORGANIZATIONS

Tool Name: Get Organizations

Description

Tool to retrieve organizations from the 21risk odata api. use when you need to list, filter, or paginate organizations via odata parameters after authentication is confirmed.

Action Parameters

$filter

string

$orderby

string

$skip

integer

$top

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_REPORTS

Tool Name: Get Reports

Description

Tool to retrieve audit reports, including draft, published, and scheduled reports. use when you need a paginated list of reports with optional odata filtering.

Action Parameters

$filter

string

$skiptoken

string

$top

integer

maxPageSizeInMb

number

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_RISKMODEL_CATEGORIES

Tool Name: Get RiskModel Categories

Description

Tool to retrieve risk model categories for grouping questions and compliance checks. use when you need to filter, select, or paginate risk model categories via odata parameters ($filter, $select, $orderby, $top, $skip, $count).

Action Parameters

$count

boolean

$expand

string

$filter

string

$orderby

string

$select

string

$skip

integer

$skiptoken

string

$top

integer

maxPageSizeInMb

integerDefaults to 50

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_RISK_MODELS

Tool Name: Get Risk Models

Description

Tool to retrieve risk models used for audits and compliance. use when you need to list available risk models with optional odata queries.

Action Parameters

$count

boolean

$expand

string

$filter

string

$orderby

string

$select

string

$skip

integer

$skiptoken

string

$top

integer

maxPageSizeInMb

number

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_SITES

Tool Name: Get Sites

Description

Tool to retrieve sites (locations) from the 21risk odata api. use when you need to list, filter, or page sites with odata query parameters after authentication is confirmed.

Action Parameters

$count

boolean

$expand

string

$filter

string

$orderby

string

$search

string

$select

string

$skip

integer

$top

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_COMPLIANCE

Tool Name: Get Compliance

Description

Tool to retrieve compliance data for sites, categories, or questions. use when you need odata-based compliance data for analytics or reporting.

Action Parameters

$count

boolean

$expand

string

$filter

string

$orderby

string

$select

string

$skip

integer

$skiptoken

string

$top

integer

_maxPageSizeInMb

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_ITEMS_PER_MONTH

Tool Name: Get Items Per Month

Description

Tool to retrieve fact table data for itemspermonth, one row per question per site per month. use when querying monthly item data with odata parameters ($filter, $top, $skip, $select, maxpagesizeinmb).

Action Parameters

$filter

string

$select

string

$skip

integer

$top

integer

maxPageSizeInMb

integerDefaults to 50

Action Response

data

objectRequired

error

string

successful

booleanRequired

_21RISK_GET_PROPERTIES

Tool Name: Get Properties

Description

Tool to fetch a list of properties related to sites, including cope information and other relevant data. use when you need property insurance details via odata api after authentication.

Action Parameters

$filter

string

$orderby

string

$select

string

$skip

integer

$top

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired