Conveyor | Composio Docs

Overview

SLUG: CONVEYOR

Description

Conveyor is a platform that automates security reviews by providing a Trust Center, AI-driven questionnaire automation, and integrations with various tools to streamline compliance processes.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Conveyor

Create an auth config

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

Select App

Navigate to Conveyor.

Configure Auth Config Settings

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

Create and Get auth config ID

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

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Conveyor toolkit’s playground

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=["CONVEYOR"])
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

CONVEYOR_DELETE_DOCUMENT

Tool Name: Delete a Conveyor document

Description

Tool to delete a specific document. Use when you need to remove a document by its ID.

Action Parameters

document_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_DELETE_FOLDER

Tool Name: Delete folder

Description

Tool to delete a folder by its ID. Use when you need to remove a specific folder after confirming its ID.

Action Parameters

folder_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GENERATE_API_TOKEN

Tool Name: Generate/Validate API Token Guidance

Description

Tool to validate API token and provide guidance. Conveyor does not support API-based token creation; tokens must be created in the Conveyor UI. This action performs a real API call (using the provided metadata) to validate the existing API token and returns structured guidance.

Action Parameters

dry_run

boolean

label

string

note

string

CONVEYOR_GET_AUTHORIZATION_REQUEST

Tool Name: Get Authorization Request

Description

Tool to fetch details of a specific authorization request. Use when you need to retrieve metadata by authorization_request_id.

Action Parameters

authorization_request_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_AUTHORIZATION_REQUESTS

Tool Name: Get Authorization Requests

Description

Tool to fetch authorization requests. Use when you need to list authorization requests, optionally filtered by status.

Action Parameters

status

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_AUTHORIZATIONS

Tool Name: Get all authorization requests

Description

Tool to retrieve all authorization requests. Use when you need to list all authorizations; optionally filter by status. Use after authenticating with a valid API token.

Action Parameters

status

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_CONNECTIONS

Tool Name: Get all Conveyor connections

Description

Tool to retrieve all connections. Use when you need to fetch the complete list of your Conveyor connections. Use after authenticating with a valid API key.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_DOCUMENTS

Tool Name: Get all Conveyor documents

Description

Tool to retrieve all documents. Use after authenticating with a valid API key.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_FOLDERS

Tool Name: Get all Conveyor folders

Description

Tool to retrieve all folders. Use after authenticating with a valid API key to fetch the complete list of your Conveyor folders.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_INTERACTIONS_BY_DOCUMENT_ID

Tool Name: Get interactions by document ID

Description

Tool to fetch interactions associated with a specific document. Use when you need to list all interactions for a given document after validating its existence.

Action Parameters

document_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_KNOWLEDGE_BASE_QUESTIONS

Tool Name: Get Knowledge Base Questions

Description

Tool to retrieve knowledge base questions. Use when you need to fetch all questions from the Conveyor knowledge base.

Action Parameters

page

integer

per_page

integer

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_GET_PRODUCT_LINES

Tool Name: Get product lines

Description

Tool to fetch all product lines. Use when you need to retrieve product lines after confirming API key validity.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_PATCH_AUTHORIZATION

Tool Name: Patch authorization

Description

Tool to update or revoke an existing authorization. Use when managing authorization access groups or revoking access.

Action Parameters

access_group_ids

array

authorization_id

stringRequired

revoke

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_PATCH_DOCUMENT

Tool Name: Patch Conveyor document

Description

Tool to update document attributes. Use when you need to modify fields of an existing document by its ID.

Action Parameters

details

object

document_id

stringRequired

name

string

status

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_POST_AUTHORIZATION

Tool Name: Create new authorization

Description

Tool to create a new authorization. Use when you need to grant access by email or from a prior authorization request.

Action Parameters

access_group_ids

array

authorization_request_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_POST_DOCUMENT

Tool Name: Upload new document

Description

Tool to upload a new document. Use when you have a local file (<=100MB) to send to Conveyor.

Action Parameters

file_path

stringRequired

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_POST_FOLDER

Tool Name: Create new folder

Description

Tool to create a new folder in Conveyor Exchange. Use when you need to organize items into folders programmatically after obtaining an API key.

Action Parameters

name

stringRequired

parent_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CONVEYOR_POST_SINGLE_QUESTION

Tool Name: Submit single question

Description

Tool to submit a single question. Use when you need an immediate AI-generated answer for a specific product line question.

Action Parameters

product_line_ids

arrayRequired

question

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired