OneTrust

OneTrust Engagements API

The Engagements APIs are used to manage vendor engagement operations including creating, retrieving, updating, and searching engagements with comprehensive attribute management, status control, workflow integration, and schema configuration capabilities.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/vendor/v1/engagement-schemas Get the engagement attribute schema · Get Engagement Schema #
Ask an LLM
“What attributes and options can I set on a vendor engagement?”
“Can I see only the active engagement attributes?”
Tell an agent
Show the engagement attribute schema.
Get engagement attributes filtered by active status {activeStatus}.
GET /api/vendor/v1/engagements/{engagementId} Get an engagement · Get Engagement #
Ask an LLM
“Which vendor, workflow and attributes belong to a specific engagement?”
“How do I pull up one vendor engagement by its ID?”
Tell an agent
Show engagement {engagementId}.
Get the vendor and workflow details for engagement {engagementId}.
PUT /api/vendor/v1/engagements/{engagementId} Replace an engagement's details · Update Engagement #
Ask an LLM
“How do I fully update a vendor engagement's owner, dates and scope?”
“Can I change an engagement's workflow stage through a full update?”
Tell an agent
Fully update engagement {engagementId} with name {name} and owner {internalOwnerEmail}.
Replace engagement {engagementId} as {name} running {startDate} to {endDate}.
DELETE /api/vendor/v1/engagements/{engagementId} Delete an engagement · Delete Engagement #
Ask an LLM
“How do I delete a vendor engagement I no longer need?”
“Can I remove an engagement by its ID?”
Tell an agent destructive · confirm first
Delete engagement {engagementId}.
Remove vendor engagement {engagementId} permanently.
PATCH /api/vendor/v1/engagements/{engagementId} Partially update an engagement · Modify Engagement #
Ask an LLM
“Can I change a single field on an engagement without resending the rest?”
“What date format does a partial engagement update expect?”
Tell an agent
Patch only the changed fields on engagement {engagementId}.
Modify engagement {engagementId} partially.
PUT /api/vendor/v1/engagements/{engagementId}/status Change an engagement's status · Update Engagement Status #
Ask an LLM
“How do I mark a vendor engagement as active or inactive?”
“Can I update just the status of an engagement?”
Tell an agent
Set engagement {engagementId} status to {status}.
Change the status of engagement {engagementId} to {status}.
POST /api/vendor/v1/engagements-search Search engagements · Search Engagements #
Ask an LLM
“Which engagements do we have with a particular vendor?”
“Can I full-text search engagements by keyword?”
Tell an agent
Search engagements for {fullText}.
Find engagements matching filters {filters}.
POST /api/vendor/v1/vendor-engagements Create a vendor engagement · Create Engagement #
Ask an LLM
“How do I start a new engagement with a vendor?”
“Which organization does a new engagement land in if I don't specify one?”
Tell an agent
Create an engagement named {name} with vendor {vendor}.
Open engagement {name} for vendor {vendor} owned by {internalOwnerEmail} starting {startDate}.

Documentation

📖
Documentation
https://developer.onetrust.com/onetrust/reference/attribute-management
📖
Documentation
https://developer.onetrust.com/onetrust/reference/activity-log
📖
Documentation
https://developer.onetrust.com/onetrust/reference/preferences-v2
📖
Documentation
https://developer.onetrust.com/onetrust/reference/banner
📖
Documentation
https://developer.onetrust.com/onetrust/reference/consent-receipts
📖
Documentation
https://developer.onetrust.com/onetrust/reference/applications
📖
Documentation
https://developer.onetrust.com/onetrust/reference/categorizations
📖
Documentation
https://developer.onetrust.com/onetrust/reference/domain-data
📖
Documentation
https://developer.onetrust.com/onetrust/reference/preferences
📖
Documentation
https://developer.onetrust.com/onetrust/reference/mobile-app-data
📖
Documentation
https://developer.onetrust.com/onetrust/reference/privacy-notice-v2
📖
Documentation
https://developer.onetrust.com/onetrust/reference/collection-points
📖
Documentation
https://developer.onetrust.com/onetrust/reference/catalog-search-v1
📖
Documentation
https://developer.onetrust.com/onetrust/reference/classification
📖
Documentation
https://developer.onetrust.com/onetrust/reference/custom-scan
📖
Documentation
https://developer.onetrust.com/onetrust/reference/carbon-management
📖
Documentation
https://developer.onetrust.com/onetrust/reference/audit-records
📖
Documentation
https://developer.onetrust.com/onetrust/reference/bulk-export
📖
Documentation
https://developer.onetrust.com/onetrust/reference/attachments
📖
Documentation
https://developer.onetrust.com/onetrust/reference/system-credentials
📖
Documentation
https://developer.onetrust.com/onetrust/reference/inventory-relationships-v2
📖
Documentation
https://developer.onetrust.com/onetrust/reference/model-management
📖
Documentation
https://developer.onetrust.com/onetrust/reference/tasks
📖
Documentation
https://developer.onetrust.com/onetrust/reference/groups-v2
📖
Documentation
https://developer.onetrust.com/onetrust/reference/assessment-actions
📖
Documentation
https://developer.onetrust.com/onetrust/reference/inventory
📖
Documentation
https://developer.onetrust.com/onetrust/reference/inventory-1
📖
Documentation
https://developer.onetrust.com/onetrust/reference/drop-management
📖
Documentation
https://developer.onetrust.com/onetrust/reference/incidents
📖
Documentation
https://developer.onetrust.com/onetrust/reference/document-controller
📖
Documentation
https://developer.onetrust.com/onetrust/reference/audits
📖
Documentation
https://developer.onetrust.com/onetrust/reference/initiatives
📖
Documentation
https://developer.onetrust.com/onetrust/reference/document-attachments
📖
Documentation
https://developer.onetrust.com/onetrust/reference/issues
📖
Documentation
https://developer.onetrust.com/onetrust/reference/control-implementations
📖
Documentation
https://developer.onetrust.com/onetrust/reference/training
📖
Documentation
https://developer.onetrust.com/onetrust/reference/contracts

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/onetrust/refs/heads/main/openapi/onetrust-engagements-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/onetrust:onetrust-engagements-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

onetrust-engagements-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Third-Party Management - Third-Party Risk Management…
  version: '1.0'
  contact:
    name: OneTrust Support
    url: https://my.onetrust.com/s/contactsupport
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  description: The Third-Party Risk Management APIs provide comprehensive functionality for managing vendor relationships, engagements, and contracts within the GRC ecosystem, enabling organizations to assess, monitor, and control third-party risks through engagement lifecycle management, contract administration, and customizable attribute schemas.
servers:
- url: https://{hostname}
  variables:
    hostname:
      default: hostname
      description: The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com.
tags:


# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/onetrust/refs/heads/main/openapi/onetrust-engagements-api-openapi.yml