Borneo

Learn how to use Borneo with Composio

Overview

Enum

BORNEO

Description

Borneo is a data security and privacy platform designed for sensitive data discovery and remediation.

Authentication Details

api_key
stringRequired
client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to openid,email,profile,phone,aws.cognito.signin.user.admin

Actions

Deletes a specific recipient from the borneo integration platform. this endpoint should be used when you need to permanently remove a recipient’s information from the system, such as when a contact is no longer valid or when correcting erroneous entries. the operation is irreversible, so it should be used with caution. once a recipient is deleted, any associated data or integration settings for that recipient will also be removed. this endpoint is particularly useful for maintaining data hygiene and complying with data retention policies.

Action Parameters

recipientId
stringRequired

Action Response

data
object
successful
boolean
error

Archives a specific discovered recipient in the borneo platform. this endpoint is used to move a discovered recipient’s data into an archived state, which may be useful for compliance, data retention, or organizational purposes. it should be called when you need to store historical data about a recipient that has been identified through borneo’s data visibility and privacy automation processes. the endpoint uses a post method, suggesting it may trigger backend processes to properly archive the recipient’s data. note that this operation might affect the visibility or accessibility of the recipient’s data in other parts of the system.

Action Parameters

discoveredRecipientId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific processing activity within the borneo platform. this endpoint allows users to access comprehensive data related to a particular data processing task or workflow, including its current status, associated metadata, and any relevant compliance information. it is particularly useful for monitoring ongoing activities, auditing past processes, or gathering information for reporting purposes. the endpoint should be used when detailed insights into a single processing activity are required, but it won’t provide an overview of multiple activities or system-wide statistics.

Action Parameters

processingActivityId
stringRequired

Action Response

data
object
successful
boolean
error

Updates the status and automation status of a specific recipient in the borneo integration platform. this endpoint allows users to modify a recipient’s overall status (archived or validated) and their automation status (ignored, created, or new). it’s particularly useful for managing recipient data lifecycle and controlling how recipients are handled in automated workflows. the endpoint should be used when there’s a need to change a recipient’s status due to changes in their relevance or to adjust their interaction with automated processes. it’s important to note that this endpoint only updates status information and does not modify other recipient details.

Action Parameters

recipientId
stringRequired
status
string
automationStatus
string

Action Response

data
object
successful
boolean
error

The post /support/chat endpoint handles chat support interactions in borneo. it processes user queries for real-time assistance with platform issues or inquiries. use this endpoint to start or continue support conversations, enabling interactive problem-solving within borneo’s ecosystem. not suitable for non-support communications or large data submissions.

Action Parameters

query
stringRequired
sessionId
string

Action Response

data
object
successful
boolean
error

The errorlist endpoint retrieves errors related to scan iterations in borneo. it offers flexible filtering, sorting, and pagination for efficient error analysis. use for debugging, monitoring, or reporting across various scans and resources. supports up to 10,000 records per call.

Action Parameters

filter__scanIterationId
string
filter__resourceId
string
filter__accountId
string
filter__scanExecutionId
string
filter__scanId
string
select
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Deletes a specific headquarters record from the borneo system. this endpoint should be used when you need to permanently remove a headquarters entry from your organization’s data. it’s particularly useful for cleaning up obsolete or erroneous headquarters data. exercise caution when using this endpoint, as the deletion is irreversible and will remove all associated data for the specified headquarters. ensure you have the correct headquarterid before proceeding with the deletion to avoid unintended data loss. this operation may have cascading effects on related data, such as employee records or location-based configurations.

Action Parameters

headquarterId
stringRequired

Action Response

data
object
successful
boolean
error

This endpoint deletes a specific lopdp (local public data protection) threshold from the borneo integration platform. it is used to remove outdated, incorrect, or no longer applicable thresholds related to data protection regulations. the deletion is permanent and cannot be undone, so it should be used with caution. this endpoint is particularly useful when updating compliance settings or when certain thresholds are no longer relevant due to changes in regulations or business processes. it should not be used for temporary disabling of thresholds; instead, use it only when the threshold needs to be completely removed from the system.

Action Parameters

lopdpThresholdId
stringRequired

Action Response

data
object
successful
boolean
error

Updates or processes information for a specific discovered recipient user in the borneo integration platform. this endpoint allows you to interact with user data that has been automatically discovered by the system, potentially as part of the integration process between different applications. use this when you need to modify, confirm, or take action on a discovered user’s information. the exact actions performed depend on the request body (not specified in the schema) but may include tasks such as confirming the user’s identity, updating their details, or initiating further integration steps. this endpoint is specific to individual users and requires the unique discoveredrecipientid to target the correct record.

Action Parameters

discoveredRecipientId
stringRequired

Action Response

data
object
successful
boolean
error

Stops an ongoing scan operation in the borneo integration platform. this endpoint allows users to halt a specific scan process that is currently in progress. it should be used when there’s a need to interrupt a scan before its natural completion, such as when the scan is taking too long, consuming excessive resources, or if the desired information has already been obtained. the endpoint requires the unique identifier of the scan to be stopped, ensuring precise control over individual scan operations. it’s important to note that stopping a scan may result in incomplete data collection or analysis, so it should be used judiciously. this operation is irreversible; once stopped, a scan cannot be resumed and would need to be restarted if further scanning is required.

Action Parameters

scanId
stringRequired

Action Response

data
object
successful
boolean
error

The listissues endpoint allows users to retrieve a filtered and sorted list of issues from the borneo integration platform. it provides extensive filtering capabilities to narrow down results based on various criteria such as resources, cloud accounts, issue states, and severities. the endpoint supports pagination for handling large result sets efficiently and allows customization of the returned data through column selection and inclusion of related resources. this powerful querying tool is essential for monitoring, troubleshooting, and managing issues across integrated systems and cloud environments in borneo.

Action Parameters

filter__resources
array
filter__resourceTypes
array
filter__cloudAccountTypes
array
filter__cloudAccountIds
array
filter__states
array
filter__severities
array
filter__search
string
filter__failedControls
array
select
array
include
object
nextToken
string
sort__column
string
sort__order
string
pageSize
integerDefaults to 10

Action Response

data
object
successful
boolean
error

Updates the infotypes associated with a specific category in the borneo integration platform. this endpoint allows you to modify the list of infotypes belonging to a category and optionally update the category’s description. it’s used for maintaining and organizing the classification of data types within the system, which is crucial for efficient data exchange and workflow automation. the endpoint replaces the entire list of infotypes for the specified category, so it should be used carefully to ensure no unintended removal of existing infotypes. this operation is particularly useful when restructuring data classifications or when new types of information need to be incorporated into existing categories.

Action Parameters

categoryLabel
stringRequired
description
string
infotypes
arrayRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific resource from the borneo catalog using its unique identifier. this endpoint is used to access comprehensive data about a particular resource, which could include metadata, associated files, or other relevant information. it should be used when detailed information about a known resource is required, such as for display purposes or further processing within an integration workflow. the endpoint will not modify the resource or return information about multiple resources. it’s important to note that the response structure is not specified in the given schema, so users should refer to borneo’s documentation for the exact format of the returned data.

Action Parameters

resourceId
stringRequired
includeParentDetails
boolean

Action Response

data
object
successful
boolean
error

Retrieves detailed inventory information for a specific resource identified by its unique resourceid. this endpoint is designed to provide up-to-date data on the quantity, quality, and status of resources managed by borneo resource investments ltd., such as mineral deposits or gold mines. it should be used when accurate, current inventory data is needed for resource planning, reporting, or analysis purposes. the endpoint returns comprehensive inventory details, which may include resource quantity, grade, extraction status, and other relevant metrics. however, it does not provide historical inventory data or future projections; it only reflects the current state of the resource inventory.

Action Parameters

resourceId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed insights for a specific scan iteration of a particular resource in the borneo integration platform. this endpoint allows users to access in-depth information about scan results, which can be used for thorough analysis, troubleshooting, or reporting purposes. it’s particularly useful when you need to examine the outcomes of a specific scan iteration in detail, either for the entire scan or for a specific page within the scan results. the endpoint requires both the resource and scan iteration identifiers to ensure precise retrieval of the relevant data. use this when you need comprehensive information about a scan’s findings, especially in scenarios involving data quality assessment, integration verification, or system health checks.

Action Parameters

scanId
stringRequired
scanIterationId
stringRequired
pageId
string
resourceId
stringRequired

Action Response

data
object
successful
boolean
error

Updates a specific technical operating model (tom) in the borneo integration platform. this endpoint allows users to modify the implementation status of a tom, add explanatory notes, and attach relevant documentation. it’s primarily used for tracking and managing the lifecycle of toms within an organization’s integration processes. the endpoint is particularly useful when the status of a tom changes, when additional context needs to be provided, or when supporting documents need to be linked to the tom. it should be used to keep tom information up-to-date and to maintain a clear record of tom progress and associated documentation.

Action Parameters

tomId
stringRequired
status
stringRequired
note
string
documentFiles
array

Action Response

data
object
successful
boolean
error

Enables dashboard access for a specified user in the borneo integration platform. this endpoint is used to grant or restore a user’s ability to view and interact with dashboards within the system. it should be called when an administrator needs to activate a user’s dashboard privileges, such as after initial account creation or if access was previously revoked. the endpoint only handles enabling access and does not provide information about the user’s current access status or other account details. note that this operation does not create a new user account; it assumes the specified username already exists in the system.

Action Parameters

username
stringRequired

Action Response

data
object
successful
boolean
error

The listtoms endpoint retrieves a filtered, sorted, and paginated list of toms from the borneo integration platform. it allows for complex querying of tom objects based on various criteria such as text search, categories, types, statuses, and ids. the endpoint supports pagination for handling large result sets and provides sorting capabilities for customized data presentation. this tool is ideal for browsing, searching, and analyzing collections of toms within the borneo system, enabling efficient data exploration and management. it should be used when a comprehensive view of toms is needed, subject to specific filtering and sorting requirements. the endpoint does not create, update, or delete toms; it is purely for retrieval and listing purposes.

Action Parameters

filter__search
string
filter__category
array
filter__list
array
filter__type
array
filter__status
array
filter__objectCategory
array
filter__tomId
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The listdatabreaches endpoint retrieves a list of data breaches based on specified filter conditions, allowing for detailed searching and sorting of breach information. it supports pagination for handling large result sets and provides flexible filtering options including free-text search, authority notification status, owner, and breach status. this endpoint is particularly useful for compliance teams, security analysts, and it administrators who need to monitor, review, or report on data breach incidents within their organization. the tool facilitates efficient data breach management, enabling users to quickly locate specific incidents or generate comprehensive reports based on various criteria.

Action Parameters

filter__search
string
filter__authoritiesNotified
array
filter__owner
array
filter__status
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Creates a new headquarters entry in the borneo integration platform. this endpoint allows users to register the main office or primary location of a company or organization within the system. it captures essential information about the headquarters, including its name, address, and associated identifiers. use this endpoint when setting up a new company profile or updating the primary business location. the endpoint ensures data consistency by enforcing specific formatting rules for each field. it’s particularly useful for organizations managing multiple locations or integrating headquarters data with other business systems.

Action Parameters

name
stringRequired
city
stringRequired
address
stringRequired
country
stringRequired
zipcode
string
tomIds
array

Action Response

data
object
successful
boolean
error

Retrieves a filtered and sorted list of connectors from the borneo integration platform. this endpoint allows you to search, filter, and paginate through available connectors based on various criteria such as names, states, types, and associated resources. it’s particularly useful for managing large numbers of connectors, monitoring their states, or finding specific connectors within your integration ecosystem. the endpoint supports advanced filtering options, pagination for handling large result sets, and customizable sorting to organize the returned data. use this when you need to audit your connector inventory, check the status of multiple connectors, or find connectors matching specific criteria.

Action Parameters

filter__search
string
filter__names
array
filter__states
array
filter__activeStates
boolean
filter__connectorIds
array
filter__dataPlaneIds
array
filter__resourceTypes
array
filter__connectorTypes
array
filter__resourceIds
array
pageSize
integer
nextToken
string
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The updateasset endpoint allows you to modify the details of an existing asset in the borneo integration platform. this put operation at /assets/{assetid}“ updates the specified asset’s information, including its name, type, associated ids, and location details. it’s crucial for maintaining accurate and up-to-date asset records within the system. use this endpoint when you need to change any attribute of an asset, such as its name, type, or location. the endpoint requires at least the asset’s name and type, with options to update additional properties like associated tom ids and location information. note that this operation will overwrite the existing asset data, so include all required fields even if only updating a subset of properties.

Action Parameters

assetId
stringRequired
name
stringRequired
type
stringRequired
tomIds
array
locationType
string
locationId
string

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific department within the borneo integration platform. this endpoint is part of the departmentsapi and is used to fetch comprehensive data about a single department, including its configuration, associated workflows, and integration settings. it’s particularly useful when you need to review or audit a department’s setup within the borneo ecosystem. the endpoint should be used when detailed information about a specific department is required, such as during troubleshooting, reporting, or when updating department configurations. note that this endpoint only provides read access to department data and cannot be used to modify department information.

Action Parameters

departmentId
stringRequired

Action Response

data
object
successful
boolean
error

Lists and retrieves events based on specified criteria, with options for filtering, sorting, and pagination. this endpoint is designed for querying event data in the borneo integration platform, allowing users to fetch events related to various entities such as issues, resources, scans, and users. it offers flexible querying capabilities through its filter object, custom sorting, and efficient pagination for handling large datasets. use this endpoint when you need to search, analyze, or monitor events within your borneo-integrated systems. the endpoint is particularly useful for generating reports, tracking specific issues, or monitoring system activities across different resources and users.

Action Parameters

filter__eventId
array
filter__issueId
array
filter__resourceId
array
filter__scanId
array
filter__userId
array
filter__search
string
filter__issueType
array
filter__newInfotypeFound
boolean
sort__column
string
sort__order
string
nextToken
string
pageSize
integer
select
array

Action Response

data
object
successful
boolean
error

Updates the properties of an existing domain within the borneo integration platform. this endpoint allows you to modify the name and polling frequency of a specific domain identified by its unique domainid. use this when you need to rename a domain or adjust its automated polling schedule. it’s particularly useful for fine-tuning the integration processes or adapting to changing business requirements. the endpoint doesn’t provide information about other domain properties or the success of the update operation, so additional verification may be necessary after making changes.

Action Parameters

domainId
stringRequired
name
stringRequired
frequency
stringRequired

Action Response

data
object
successful
boolean
error

Updates the lopdp (likely operational privacy data protection) threshold settings for a specific threshold identified by the lopdpthresholdid. this endpoint allows you to modify various data protection and privacy compliance parameters related to data processing activities. use this endpoint when you need to adjust risk assessments, update processing characteristics, or change the status of a threshold. the endpoint is crucial for maintaining up-to-date privacy impact assessments and ensuring compliance with data protection regulations. note that this endpoint only updates the threshold settings and does not perform any actual data processing or risk mitigation actions.

Action Parameters

lopdpThresholdId
stringRequired
comment
string
systematicPersonalAssessment
boolean
largeScaleObservation
boolean
processingPersonalDataRisk
boolean
specialCategoryDataProcessed
boolean
sensitiveOrSpecialData
boolean
rightsRiskProcessingData
boolean
freedomRiskProcessingData
boolean
innovativeTechnologiesUsed
boolean
processingVulnerableDataSubject
boolean
additionalComment
boolean
status
string

Action Response

data
object
successful
boolean
error

Deletes a specific department from the borneo platform using its unique identifier. this endpoint should be used when you need to remove a department that is no longer relevant or has been decommissioned. it’s important to note that this operation is irreversible and will permanently remove all data associated with the specified department. use this endpoint with caution, as it may impact resource management and organizational structure within the borneo context. before deletion, ensure that all necessary data has been backed up or transferred to other relevant departments if required.

Action Parameters

departmentId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific asset within the borneo integration platform. this endpoint allows users to fetch comprehensive data about a single asset, including its properties, metadata, and current status. it should be used when detailed information about a particular asset is needed, such as during asset management, auditing, or when integrating asset data with other systems. the endpoint provides a snapshot of the asset’s current state and attributes, which can be crucial for decision-making in data governance, security analysis, or integration processes. note that this endpoint only retrieves information and does not modify the asset in any way. it may not provide historical data or version history of the asset, focusing instead on its current state.

Action Parameters

assetId
stringRequired

Action Response

data
object
successful
boolean
error

The filteremployeelist endpoint allows you to retrieve a filtered list of employees based on specified criteria. this post operation is designed for querying employee data within the borneo integration platform, enabling efficient data retrieval for various business processes and integrations. use this endpoint when you need to fetch a subset of employee records matching particular conditions, such as department, job title, or hire date. the endpoint supports pagination for handling large result sets, making it suitable for applications that need to display or process employee data in manageable chunks. note that the specific filterable fields may vary depending on your borneo instance configuration and available employee data.

Action Parameters

Action Response

data
object
successful
boolean
error

Updates the information of an existing employee in the borneo integration platform. this endpoint allows you to modify various details of an employee’s record, including personal information, job-related data, and organizational relationships. it’s primarily used for maintaining up-to-date employee records, reflecting changes in positions, departments, or personal details. the endpoint requires the employee’s unique identifier and accepts a json object containing the updated information. while it offers flexibility in updating multiple fields, it’s important to note that the email address must remain unique within the company. this tool should be used whenever there are changes to an employee’s information that need to be reflected in the system, but should not be used for creating new employee records or for bulk updates.

Action Parameters

employeeId
stringRequired
name
string
surname
string
position
string
nif
string
startDate
string
endDate
string
email
string
manager
string
department
string

Action Response

data
object
successful
boolean
error

The submitchatfeedback endpoint allows users to provide feedback on a chat support interaction within the borneo integration platform. this endpoint is crucial for collecting user satisfaction data, which can be used to improve the quality of support and enhance the overall user experience. it should be called after a chat support session has concluded, enabling users to rate their interaction with the support team. the feedback submitted through this endpoint can help borneo identify areas for improvement in their support processes and recognize high-performing support agents. note that this endpoint focuses solely on collecting numerical ratings and does not appear to support additional comments or detailed feedback.

Action Parameters

postId
string
rating
integer

Action Response

data
object
successful
boolean
error

Updates the information for an existing headquarter in the borneo integration platform. this endpoint allows you to modify various details of a headquarter, such as its name, address, and associated tom ids. it should be used when there are changes to a headquarter’s information or when correcting existing data. the endpoint requires the headquarter’s unique identifier and accepts a json payload with the updated information. it enforces strict validation rules to ensure data integrity and consistency across the platform. note that while some fields are optional, others (name, city, address, and country) are mandatory and must be provided with each update request.

Action Parameters

headquarterId
stringRequired
name
stringRequired
city
stringRequired
address
stringRequired
country
stringRequired
zipcode
string
tomIds
array

Action Response

data
object
successful
boolean
error

Creates a new asset in the borneo integration platform. this endpoint allows users to add various types of assets to their inventory, ranging from hardware and software applications to office furniture and documentation. it’s primarily used when onboarding new resources or updating the asset registry. the endpoint captures essential information about each asset, including its type, location, and associated identifiers. it’s particularly useful for organizations managing diverse asset portfolios across multiple locations. note that while creating an asset, only the name and type are required, allowing for flexible asset management workflows.

Action Parameters

name
stringRequired
type
stringRequired
tomIds
array
locationType
string
locationId
string
createdAt
integer

Action Response

data
object
successful
boolean
error

Creates a new data breach report in the borneo platform. this endpoint allows users to submit comprehensive information about a data breach incident, including details about the occurrence, discovery, affected data and individuals, security measures, and follow-up actions. the report can be saved as a draft or submitted as a final version. it supports multiple languages and allows for the inclusion of additional related information through uuids. this tool should be used when documenting and reporting data breach incidents within an organization, helping to ensure compliance with data protection regulations and facilitating incident response and analysis. it’s particularly useful for security teams, compliance officers, and data protection officers who need to maintain detailed records of data breaches.

Action Parameters

shortDescription
stringRequired
occurredAt
integer
discoveredAt
integer
description
string
howDiscovered
string
wasIntentional
string
kindOfData
string
profilePeopleAffected
string
consequences
string
affectedPeopleFrom
string
numberAffectedPeople
integer
securityMeasuresOrProtocols
string
measuresToPrevent
string
problemOfSecurityMeasures
string
peopleInformed
string
authoritiesInformed
string
additionalInformation
array
createdBy
string
compromisedSensitiveData
string
saveAsDraft
booleanRequired
createdAt
integer
language
string

Action Response

data
object
successful
boolean
error

Updates the roles and department associations for a specified user across multiple organizations in the borneo dashboard. this endpoint allows administrators to modify a user’s access levels and departmental affiliations within the borneo system. it’s particularly useful for managing user permissions when responsibilities change or when adjusting access across different organizations and departments. the endpoint requires specifying the username and at least one organization with assigned roles. department associations are optional but must be provided as valid uuids when included. this tool should be used when there’s a need to modify existing user role configurations, not for creating new users or removing users from the system entirely.

Action Parameters

username
stringRequired
organisations
arrayRequired

Action Response

data
object
successful
boolean
error

The listleafresources endpoint retrieves and filters leaf resources from borneo’s catalog. it supports detailed searching across various criteria, enabling efficient resource management and discovery. users can paginate results, include additional information, and sort outputs as needed.

Action Parameters

sourceType
string
filter__search
string
filter__account
array
filter__instance
array
filter__database
array
filter__dataset
array
filter__schema
array
filter__driveId
array
filter__orgUnitId
array
filter__driveType
array
filter__region
array
filter__status
array
filter__parentId
string
filter__resourceId
array
filter__resourceType
array
filter__scanned
boolean
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
filter__classification
array
filter__categories
array
filter__spaceStatus
array
filter__spaceType
array
filter__severityScore
array
filter__resourceTags
array
filter__noOwner
boolean
filter__hasOwner
boolean
filter__firstSeen
object
include__violationSummary
boolean
include__frameworkExceptionsCount
boolean
pageSize
integer
nextToken
string
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Downloads a specific dashboard report edition from the borneo integration platform. this endpoint allows users to retrieve a particular version or iteration of a dashboard report by providing its unique identifier. it should be used when a user needs to access or save a specific report edition, perhaps for archival purposes, offline analysis, or to compare different versions of a report. the endpoint accepts a post request with a json payload containing the report edition id. it’s important to note that this tool only handles the download process and does not provide functionalities for listing available reports, creating new reports, or modifying existing ones. users should ensure they have the correct reporteditionid before making the request, as the schema does not specify any error handling for invalid ids.

Action Parameters

reportEditionId
stringRequired

Action Response

data
object
successful
boolean
error

Adds multiple discovered recipients to the system as confirmed recipients. this endpoint should be used when you have a list of previously discovered recipient ids that you want to officially add to your recipient database. it’s particularly useful for bulk operations where multiple recipients need to be added simultaneously. the endpoint accepts an array of unique uuids, allowing for efficient processing of multiple recipients in a single api call. note that this endpoint only adds recipients; it does not provide any information about the recipients or perform any other actions beyond adding them to the system.

Action Parameters

discoveredRecipientIds
arrayRequired

Action Response

data
object
successful
boolean
error

Updates an existing threshold in the borneo integration platform with new settings and information related to data processing and compliance. this endpoint allows you to modify various aspects of a threshold, including its status, comments, and multiple boolean flags that define the characteristics of the data processing activities. use this endpoint when you need to adjust the parameters of a threshold to reflect changes in data handling practices, compliance requirements, or to activate a draft threshold. the endpoint is particularly useful for maintaining up-to-date records of data processing activities and ensuring compliance with data protection regulations. note that updating a threshold does not automatically apply the changes to ongoing data processing; it may require additional steps to implement the updated settings in your data workflows.

Action Parameters

thresholdId
stringRequired
comment
string
extensiveAutomatedEvaluationCharacteristics
boolean
largeScaleProcessingSensitiveData
boolean
monitoringPubliclyAccessibleAreas
boolean
blacklist
boolean
classifyingDataSubject
boolean
automatedDecisionMaking
boolean
systematicMonitoringDataSubject
boolean
processingConfidentialSensitiveData
boolean
largeScaleDataProcessing
boolean
matchingMergingRecordsInvolved
boolean
processingVulnerableDataSubject
boolean
innovativeTechnologiesUsed
boolean
preventDataSubjectsExercisingTheirRights
boolean
status
string
translations
object

Action Response

data
object
successful
boolean
error

Creates or schedules a dashboard report in the borneo integration platform for privacy operations and data discovery. this endpoint allows users to generate various types of reports, including privacy ops dashboard, data discovery dashboard, and privacy ops data flow. it supports both immediate and scheduled report generation with flexible frequency options. the tool is designed to help organizations track sensitive data, ensure compliance, and manage privacy across their infrastructure. use this endpoint when you need to set up regular privacy and data discovery reports or generate one-time reports for immediate analysis. note that the endpoint does not provide real-time data but rather creates reports based on the most recent data available at the time of report generation.

Action Parameters

name
stringRequired
reportTypes
arrayRequired
recipientsEmail
array
externalEmail
array
roles
array
status
stringRequired
frequency
string
createdBy
string
triggerImmediately
booleanRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific discovered recipient using their unique identifier. this endpoint is part of the recipient management and discovery process within the borneo integration platform. it should be used when you need to access comprehensive data about a particular recipient that has been identified or discovered by the system. the endpoint is useful for verifying recipient details, updating records, or integrating recipient information into other workflows. note that this endpoint only provides information for recipients that have already been discovered and added to the system; it cannot be used to search for new recipients or modify existing recipient data.

Action Parameters

discoveredRecipientId
stringRequired

Action Response

data
object
successful
boolean
error

The createscan endpoint initiates a new scan operation in the borneo integration platform, allowing users to configure and schedule data scans across various cloud resources. this powerful tool enables users to set up both one-time and recurring scans, with extensive customization options for resource selection, data inspection policies, and scan limits. it’s particularly useful for compliance checks, sensitive data discovery, and regular security audits across cloud environments. the endpoint supports a wide range of resource types and provides flexible scheduling options, from immediate execution to complex cron-based recurring scans. users should carefully consider the scan configuration to balance thoroughness with resource utilization, especially for large-scale environments. while highly versatile, users should note that some features may be resource-type dependent, and should refer to borneo’s documentation for specific connector and filter support.

Action Parameters

name
string
scanType
string
resourceType
string
resources__accountId
string
resources__region
string
resources__regions
array
resources__search
string
resources__resourceType
string
resources__resourceIds
array
resources__parentId
string
resources__isPublic
boolean
resources__isUnencrypted
boolean
resources__tags
array
resources__database
array
resources__dataset
array
resources__name
array
resources__schema
array
resources__driveId
array
resources__zendeskGroupId
array
resources__googleGroups
array
resources__orgUnitId
array
resources__driveType
array
resources__infoTypes__infoTypes
array
resources__infoTypes__ops
string
resources__isArchived
boolean
resources__isExternal
boolean
resources__teamId
string
resources__teamName
string
resources__teamUrl
string
resources__isPrivate
boolean
resources__isSlackDirectMessages
boolean
resources__spaceStatus
array
resources__spaceType
array
resources__all
boolean
connectorId
string
scheduleType
stringRequired
cron
string
scanFilter
array
inspectionPolicy__collectTokens
boolean
inspectionPolicy__maskDetails
boolean
inspectionPolicy__infotypes
array
inspectionPolicy__compliance
array
scanLimits__samplePercentage
integer
scanLimits__maxCumulativeDataSizeMb
integer
scanLimits__itemsPerBatch
integer
scanLimits__sampleDurationMinutes
integer
schedule__calendars
array
schedule__timezone
string

Action Response

data
object
successful
boolean
error

The listaccesslogs endpoint retrieves and filters access logs from the borneo integration platform. it allows users to search, filter, and paginate through logs based on various criteria such as user email, operation type, request id, and time range. this endpoint is essential for monitoring system activity, troubleshooting issues, and maintaining security compliance. use this endpoint when you need to analyze system usage, track specific user actions, or investigate particular requests or operations. it’s particularly useful for auditing purposes, performance monitoring, and identifying patterns or anomalies in system access. the endpoint supports detailed filtering options, allowing for precise log retrieval. however, it’s important to note that the results are limited to api logs only, and the maximum number of logs returned per call is capped at 10,000. for comprehensive log analysis, multiple calls may be necessary using the pagination feature.

Action Parameters

filter__search
string
filter__email
string
filter__operationName
string
filter__requestId
string
filter__start
string
filter__end
string
pageSize
integer
nextToken
string

Action Response

data
object
successful
boolean
error

Exports a filtered and sorted list of inventory resources from the borneo integration platform. this endpoint allows for extensive customization of the exported data, including pagination, field selection, sorting, and filtering based on various criteria such as account, region, resource type, and tags. it also provides options to include aggregated statistics from child resources, violation metrics, and framework exception counts. use this endpoint when you need to retrieve a comprehensive, customized view of your inventory resources for analysis, reporting, or integration with other systems. the exported data can be further processed or used for compliance, resource management, or security auditing purposes. note that the response may be paginated for large result sets, requiring multiple api calls to retrieve all data.

Action Parameters

pageSize
integer
nextToken
string
select
array
sort__column
string
sort__order
string
filter__accountId
string
filter__region
string
filter__regions
array
filter__search
string
filter__resourceType
string
filter__resourceIds
array
filter__parentId
string
filter__firstSeen
object
filter__noOwner
boolean
filter__hasOwner
boolean
filter__hasPii
boolean
filter__dataRisks
array
filter__severityScore
array
filter__hideBorneoResources
boolean
filter__dataSourceCategories
array
filter__classification
array
filter__scannableResourceTypes
boolean
filter__resourceTags
array
include__childResourceStats__scans
boolean
include__childResourceStats__dataSize
boolean
include__violationMetrics
boolean
include__frameworkExceptionsCount
boolean

Action Response

data
object
successful
boolean
error

Deletes a specific data breach evaluation record from the borneo system. this endpoint should be used when an organization needs to remove an evaluation record, typically in cases where the record is no longer relevant, contains errors, or needs to be purged for compliance reasons. the operation is irreversible, so it should be used with caution. this tool is part of borneo’s databreachmanagement functionality, supporting the platform’s data protection and privacy management capabilities. it helps maintain an accurate and up-to-date record of data breach evaluations, which is crucial for regulatory compliance and risk management.

Action Parameters

dataBreachId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific lopdp (logical object data point) threshold configuration within the borneo integration platform. this endpoint is used to access the settings and parameters of a particular threshold, which are crucial for monitoring system performance and triggering alerts. it should be used when detailed information about a specific threshold’s configuration is needed, such as during system audits, troubleshooting, or when adjusting monitoring parameters. the endpoint does not modify any settings; it only provides read access to the existing configuration. keep in mind that the response will likely include sensitive system configuration data, so access should be restricted to authorized personnel.

Action Parameters

lopdpThresholdId
stringRequired

Action Response

data
object
successful
boolean
error

The filterrecipientslist endpoint allows users to retrieve a filtered list of recipients based on specified criteria. this post method endpoint is designed to narrow down a potentially large set of recipients to a more manageable subset that meets certain conditions. it’s particularly useful for targeting specific groups of recipients for communication, data analysis, or other operations within the borneo integration platform. the endpoint supports pagination to handle large result sets efficiently. while it provides powerful filtering capabilities, users should be aware that the performance may vary depending on the complexity of the filter criteria and the size of the recipient database. this endpoint should be used when there’s a need to identify and work with a specific subset of recipients rather than the entire list.

Action Parameters

Action Response

data
object
successful
boolean
error

Retrieves comprehensive statistical information about data resources across the borneo integration platform. this endpoint provides valuable insights into the overall data landscape, including metrics related to data security, privacy intelligence, and observability. it should be used when you need a high-level overview of your data resources, including potential security risks, privacy compliance status, and data distribution across integrated systems. the endpoint does not accept any parameters, suggesting it returns a complete snapshot of data stats for all accessible resources. keep in mind that the response may be extensive and could take longer to process for large-scale integrations with numerous data sources.

Action Parameters

sourceType
string

Action Response

data
object
successful
boolean
error

Creates a new threshold for a specific data processing activity in the context of lopdp (law on personal data protection) compliance. this endpoint is used to define and assess various risk factors associated with data processing activities. it allows for the creation of detailed risk profiles by setting multiple boolean flags for different aspects of data processing, such as systematic personal assessment, large-scale observation, and handling of sensitive data. the threshold can be saved as a draft or activated immediately. this tool is essential for organizations to evaluate and document their data processing activities for compliance purposes and risk management.

Action Parameters

processingActivityId
stringRequired
comment
string
systematicPersonalAssessment
boolean
largeScaleObservation
boolean
processingPersonalDataRisk
boolean
specialCategoryDataProcessed
boolean
sensitiveOrSpecialData
boolean
rightsRiskProcessingData
boolean
freedomRiskProcessingData
boolean
innovativeTechnologiesUsed
boolean
processingVulnerableDataSubject
boolean
additionalComment
boolean
status
string

Action Response

data
object
successful
boolean
error

Deletes a specific processing activity from the borneo integration platform. this endpoint should be used when you need to permanently remove a data processing activity that is no longer required or valid. it’s important to note that this action is irreversible, and once a processing activity is deleted, it cannot be recovered. use this endpoint with caution, as it may impact existing data flows or integrations that depend on the deleted activity. the endpoint does not return the deleted data; it typically returns a success status if the deletion was completed successfully.

Action Parameters

processingActivityId
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new infotype category in the borneo integration platform, allowing users to organize and group related sensitive data types. this endpoint is used to establish a structured hierarchy for managing various infotypes, such as pii, pfi, and phi, enhancing data protection and compliance efforts. the created category serves as a container for specific infotypes, facilitating efficient data classification and management within the borneo ecosystem.

Action Parameters

categoryLabel
stringRequired
description
string
infotypes
arrayRequired

Action Response

data
object
successful
boolean
error

Retrieves a list of domains in the borneo integration platform with support for pagination and custom sorting. this endpoint allows users to fetch domain information in manageable chunks and order the results based on specific criteria. it’s particularly useful for applications that need to display or process large sets of domain data efficiently. the endpoint does not provide filtering capabilities, so all domains accessible to the authenticated user will be listed. use this when you need to enumerate or browse through the domains registered in your borneo account, such as for administrative purposes or to populate domain selection interfaces.

Action Parameters

nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Triggers the generation or retrieval of a specific dashboard report in the borneo integration platform. this endpoint is used to initiate the process of compiling and presenting data for a predefined dashboard report. it’s particularly useful when you need to refresh or generate an up-to-date version of a report on demand. the endpoint should be called when a user or system requires the latest data to be reflected in a dashboard report. it’s important to note that this endpoint only initiates the report generation process and may not immediately return the report data. depending on the complexity and size of the report, there might be a processing time before the actual report becomes available.

Action Parameters

dashboardReportId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves statistics about resources within the borneo integration platform. this endpoint provides valuable insights into the current state and usage of resources in your borneo environment. it can be used to monitor resource utilization, track changes over time, and inform decision-making about resource management and scaling. the endpoint allows for optional inclusion of deleted resources in the statistics, providing flexibility in data analysis. it’s particularly useful for administrators and developers who need to understand the overall resource landscape of their borneo implementation. note that this endpoint focuses on aggregated statistics and may not provide detailed information about individual resources.

Action Parameters

includeDeletedResources
boolean

Action Response

data
object
successful
boolean
error

This endpoint updates the information of an existing department within the borneo integration platform. it allows you to modify the name of a specific department identified by its unique departmentid. use this endpoint when you need to rename a department or correct its name in the system. the endpoint is particularly useful for maintaining accurate organizational structure data, which is crucial for workflow automation and integration processes. note that this operation only updates the department’s name and does not affect any other attributes or associations of the department. ensure that the new name adheres to your organization’s naming conventions and accurately represents the department’s function.

Action Parameters

departmentId
stringRequired
name
string

Action Response

data
object
successful
boolean
error

This endpoint retrieves a list of available filters for processing activities in the pops (processing of personal data) dashboard. it allows users to obtain filter options based on various categories related to data processing activities. the endpoint is designed to support dynamic filtering capabilities in the dashboard, enabling users to refine their view of processing activities according to different criteria. use this endpoint when you need to populate filter options in the user interface or when preparing to filter the main processing activities list. it’s important to note that this endpoint only returns the available filter options and does not perform the actual filtering of processing activities.

Action Parameters

filterType
stringRequired

Action Response

data
object
successful
boolean
error

Updates the status of a specific discovered infotype in the borneo integration platform. this endpoint allows users to change the state of an infotype that has been identified during data discovery processes. it is used to manage the lifecycle of discovered infotypes, enabling actions such as approval, ignoring, or deletion. the endpoint should be called when there’s a need to change the current status of a discovered infotype, typically as part of data governance or classification workflows. it’s important to note that this endpoint only updates the status and doesn’t provide additional information about the infotype itself.

Action Parameters

discoveredInfotypeId
stringRequired
status
stringRequired

Action Response

data
object
successful
boolean
error

This endpoint updates an existing processing activity in a data privacy management system. it modifies details about personal data processing, crucial for compliance with regulations like gdpr. use it to update activity status, purpose, legal basis, data subjects, and more. only ‘active’ and ‘name’ fields are required, but providing comprehensive information is recommended for accurate records.

Action Parameters

processingActivityId
stringRequired
active
booleanRequired
additionalInfo
string
additionalInfoFiles
array
assets
array
companyRole
array
contactPerson
string
dataSources
array
processingActivitiesAsDataSources
array
dataSubjects
array
dataTypes
array
departments
array
lawfulBasis
array
modelId
string
name
stringRequired
purpose
string
recipients
array
retentionPeriod__unit
string
retentionPeriod__value
integer
retentionPeriodComment
string
infotypes
array
infotypeCategories
array
infotypeVolume
string
processingFrequency
string
processingFrequencyComment
string
isDataStored
boolean
areAccessRequestsManaged
boolean
managementMethods
array
translations
object
owner
string
dataFlowRelationships
array
showOnRopaDocument
boolean

Action Response

data
object
successful
boolean
error

Lists and retrieves discovered recipients in the borneo integration platform. this endpoint allows for paginated, sorted, and filtered access to the discovered recipients data. it’s designed for efficiently managing and exploring large sets of recipient information, supporting various query parameters for customized result sets. use this endpoint when you need to browse, search, or analyze discovered recipients based on specific criteria or in a particular order.

Action Parameters

nextToken
string
pageSize
integer
sort__column
string
sort__order
string
filter__search
string
filter__status
string
filter__discoverySource
array

Action Response

data
object
successful
boolean
error

The downloaddashboardreport endpoint allows users to download specific types of dashboard reports from the borneo integration platform. this post endpoint is designed to generate and retrieve comprehensive reports related to privacy operations, data discovery, and data flow within an organization’s systems. it should be used when detailed insights into data management, privacy compliance, or data flow visualizations are required. the endpoint is particularly useful for privacy officers, data analysts, or system administrators who need to review or present aggregated data on the organization’s data handling practices. note that the report generation process may take some time depending on the complexity and amount of data being analyzed, so users should be prepared for a potential delay before receiving the downloaded report.

Action Parameters

reportType
stringRequired

Action Response

data
object
successful
boolean
error

The resumedatascan endpoint allows users to resume a previously paused or interrupted data scan operation within the borneo integration platform. this put request is used to continue the scanning process for privacy risks or data vulnerabilities that was halted earlier. the endpoint is particularly useful in scenarios where a scan was temporarily stopped due to system maintenance, network issues, or intentional pausing. it should be used when there’s a need to complete an unfinished scan without starting the entire process from the beginning. this tool doesn’t initiate new scans or modify the scan parameters; it simply continues the existing scan from where it left off.

Action Parameters

scanId
stringRequired

Action Response

data
object
successful
boolean
error

The filterdepartmentlist endpoint allows users to retrieve a filtered list of departments from the borneo integration platform. it accepts various filtering criteria to narrow down the results based on department attributes such as name, location, or size. this endpoint is particularly useful for searching specific departments or generating customized department lists for reporting or integration purposes. the filtered results can be sorted and paginated for easier data handling and display. while it provides powerful filtering capabilities, it does not modify any department data and is intended for read-only operations.

Action Parameters

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific recipient identified by their unique recipientid within the borneo integration platform. this endpoint is used to fetch comprehensive data about a recipient, which may include personal details, contact information, associated accounts, or any other relevant data stored in the borneo system. it’s particularly useful when you need to access or display a recipient’s full profile or verify their information. the endpoint should be used when detailed recipient information is required for operations such as data verification, profile updates, or displaying recipient details in a user interface. note that this endpoint only provides read access to recipient data and cannot be used to modify recipient information.

Action Parameters

recipientId
stringRequired

Action Response

data
object
successful
boolean
error

The listleafresources endpoint exports a comprehensive list of leaf resources in the borneo integration platform, allowing for extensive filtering, sorting, and detailed information retrieval. it’s designed to facilitate data discovery, classification, and management across various cloud providers and services. this endpoint is particularly useful for conducting audits, managing data governance, or preparing reports on resource usage and sensitive data distribution across the organization’s digital landscape. the function supports a wide range of filtering options, enabling precise querying based on resource attributes, metadata, and detected sensitive information. users can customize the output by sorting results and requesting detailed column-level information on detected infotypes. while powerful, users should be mindful of potential performance impacts when requesting detailed information or using complex filters on large datasets.

Action Parameters

sourceType
string
filter__search
string
filter__account
array
filter__instance
array
filter__database
array
filter__dataset
array
filter__schema
array
filter__driveId
array
filter__orgUnitId
array
filter__driveType
array
filter__region
array
filter__status
array
filter__parentId
string
filter__resourceId
array
filter__resourceType
array
filter__scanned
boolean
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
filter__classification
array
filter__categories
array
filter__spaceStatus
array
filter__spaceType
array
filter__severityScore
array
filter__resourceTags
array
filter__noOwner
boolean
filter__hasOwner
boolean
filter__firstSeen
object
sort__column
string
sort__order
string
detailed
boolean

Action Response

data
object
successful
boolean
error

The listuserprofiles endpoint retrieves a paginated and filterable list of user profiles from borneo. it supports custom querying with search, field selection, sorting, and pagination. ideal for user management, reporting, and data synchronization tasks. the endpoint offers flexible data retrieval, optimizing for efficiency. note the 10,000 item limit per request, requiring pagination for larger datasets.

Action Parameters

filter__search
string
select
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The listcategories endpoint allows users to retrieve a list of categories from the borneo integration platform. it provides flexible options for filtering and sorting the results, enabling efficient category management and exploration. this endpoint is particularly useful when you need to fetch a subset of categories or organize them in a specific order for display or processing purposes. the response will include category information based on the applied filters and sorting criteria. note that this endpoint does not create, update, or delete categories; it is solely for retrieving existing category data.

Action Parameters

filter__categories
array
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Updates the information of an existing dashboard user in the borneo integration platform. this endpoint allows you to modify the name associated with a user’s account while maintaining their unique username. it should be used when there’s a need to update a user’s display name or correct any errors in the existing name. the endpoint requires both the username (for identification) and the new name to be provided. it’s important to note that this operation only updates the user’s name and does not affect any other user data or permissions.

Action Parameters

username
stringRequired
name
stringRequired

Action Response

data
object
successful
boolean
error

Deletes a specific category from the borneo integration platform using its unique label. this endpoint should be used when you need to remove an entire category and all its associated data from the system. it’s particularly useful for cleaning up outdated or unnecessary categories. be cautious when using this endpoint, as the deletion is permanent and cannot be undone. this operation will fail if the specified category doesn’t exist or if there are any dependencies preventing its deletion.

Action Parameters

categoryLabel
stringRequired

Action Response

data
object
successful
boolean
error

This endpoint allows users to evaluate and document details of a data breach incident. it is used to capture comprehensive information about a breach, including notifications made, affected parties, and an overall assessment. the endpoint supports saving evaluations as drafts, enabling users to revisit and complete the documentation process over multiple sessions if needed. the tool should be used when there’s a need to record and assess the impact and response to a data breach, whether it’s a new incident or an update to an existing evaluation. it’s particularly useful for compliance purposes, helping organizations track their breach notification efforts and maintain detailed records of each incident. it’s important to note that this endpoint does not automatically notify authorities or affected parties; it merely records whether such notifications have been made. users should ensure they follow appropriate breach notification procedures separately from using this tool.

Action Parameters

dataBreachId
stringRequired
authoritiesNotified
boolean
reportLanguage
string
evaluation
string
dataSubjectsNotified
boolean
processorNotified
boolean
processorsInvolved
string
companiesAffected
string
role
string
dataBreachLocation
string
dataBreachController
string
saveAsDraft
booleanRequired

Action Response

data
object
successful
boolean
error

The listdepartments endpoint retrieves a list of departments within the borneo integration platform. it offers flexible querying with filtering, pagination, and sorting options. use this endpoint to explore organizational structure, manage department hierarchies, or integrate department information into other systems. note that it does not support creating, updating, or deleting departments.

Action Parameters

filter__search
string
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The listscanexecutions endpoint retrieves and filters inspection results from scan executions in the borneo integration platform. it allows users to query scan results with highly granular control, supporting filtering by scan ids, resource ids, infotypes, statuses, and confidence levels. this endpoint is particularly useful for analyzing scan outcomes, tracking specific resources, and managing large datasets through pagination and sorting capabilities. it should be used when you need to review or analyze the results of previous scans, especially when dealing with a large number of scanned resources or when looking for specific types of detected information. the endpoint does not perform new scans; it only retrieves and organizes existing scan results. keep in mind that the response may be truncated if there are more results than the specified page size, requiring the use of the nexttoken for subsequent requests to retrieve all relevant data.

Action Parameters

filter__search
string
filter__scanId
string
filter__scanIterationId
string
filter__resourceIds
array
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
filter__statuses
array
filter__infotypeConfidence
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The deleteasset endpoint removes a specific asset from the borneo integration platform. this operation is used when an asset needs to be permanently deleted from the system, such as when it’s no longer relevant or has been decommissioned. the deletion is irreversible, so it should be used with caution. this endpoint is particularly useful for maintaining an up-to-date asset inventory, cleaning up obsolete data, or managing system resources. it’s important to note that deleting an asset may have implications on related data or integrations, so users should ensure that the asset is no longer needed before proceeding with deletion.

Action Parameters

assetId
stringRequired

Action Response

data
object
successful
boolean
error

The geterrordetails endpoint retrieves detailed information about a specific error in the borneo integration platform using its unique identifier. this tool is designed to provide comprehensive error data, including error type, description, timestamp, and any associated metadata, which is crucial for effective error management and resolution. it should be used when investigating specific error occurrences, troubleshooting issues, or gathering data for error analysis and reporting. the endpoint is particularly useful for system administrators, developers, and support teams who need to access detailed error information quickly. however, it does not provide aggregated error statistics or perform any error resolution actions; it’s purely for fetching individual error details.

Action Parameters

errorId
stringRequired

Action Response

data
object
successful
boolean
error

Creates or uploads a new legal document in the borneo integration platform with specified metadata. this endpoint allows users to add various types of legal documents, such as privacy policies or data processing agreements, to the system. it captures essential information about the document, including its location, type, applicable region, and discovery settings. use this endpoint when you need to integrate new legal documents into your workflow or update existing ones with new versions. the tool is particularly useful for maintaining a centralized repository of legal documents across different regions and categories within your organization.

Action Parameters

documentLink
stringRequired
name
stringRequired
type
string
source
string
region
stringRequired
isDiscoverInfotype
booleanRequired
fromDiscoveredDocumentId
string

Action Response

data
object
successful
boolean
error

The list scans endpoint retrieves a filtered and sorted list of scans from the borneo integration platform. it allows users to query scan data with extensive filtering options, including search terms, scan types, connector ids, resources, data planes, and scan statuses. the endpoint supports pagination for handling large result sets and provides control over the returned fields and sorting order. this tool is particularly useful for monitoring scan activities, analyzing scan results across different resources and connectors, and managing large-scale scanning operations in cloud environments.

Action Parameters

filter__search
string
filter__scanType
array
filter__connectorId
array
filter__resources
array
filter__resourceType
array
filter__dataPlaneName
array
filter__dataPlaneId
array
filter__status
array
filter__accountId
array
filter__gcpProjectId
array
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
select
array
nextToken
string
pageSize
integer
getNextExecution
boolean
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Retrieves a paginated list of processing activities associated with a specific recipient in the borneo integration platform. this endpoint allows you to fetch and navigate through large sets of processing activity data efficiently. it supports sorting and pagination to help manage the volume of data returned. use this endpoint when you need to review or analyze the processing activities for a particular recipient, such as for compliance audits or data governance purposes. the endpoint does not provide filtering capabilities beyond the recipient id, so all processing activities for the specified recipient will be included in the results.

Action Parameters

recipientId
stringRequired
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The headquarters list endpoint retrieves a paginated list of headquarters records from borneo. it supports efficient querying of large datasets through pagination and custom sorting. this endpoint is ideal for applications needing to display or process headquarters information in batches, such as for reports or dashboards. it offers flexible result retrieval and sorting capabilities, but lacks built-in filtering options.

Action Parameters

nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Creates a new processing activity in the borneo integration platform. this endpoint allows users to define and configure detailed attributes of a data processing activity, including its purpose, legal basis, data sources, subjects, retention policies, and organizational roles. it’s essential for organizations to document their data processing activities for compliance with data protection regulations. use this endpoint when setting up a new data processing workflow or updating existing processes in your organization’s data management strategy.

Action Parameters

active
booleanRequired
additionalInfo
string
additionalInfoFiles
array
assets
array
companyRole
array
contactPerson
string
dataSources
array
processingActivitiesAsDataSources
array
dataSubjects
array
dataTypes
array
departments
array
lawfulBasis
array
modelId
string
name
stringRequired
purpose
string
recipients
array
retentionPeriod__unit
string
retentionPeriod__value
integer
retentionPeriodComment
string
infotypes
array
infotypeCategories
array
infotypeVolume
string
processingFrequency
string
processingFrequencyComment
string
isDataStored
boolean
areAccessRequestsManaged
boolean
managementMethods
array
language
string
createdAt
integer
updatedAt
integer
translations
object
owner
string
dataFlowRelationships
array
showOnRopaDocument
boolean

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific category within borneo’s data classification system using the category’s unique label. this endpoint is used to fetch metadata, attributes, and potentially associated data points for a given category. it’s particularly useful for understanding the structure and properties of a category, which can be crucial for data governance, compliance reporting, and workflow automation tasks. the endpoint should be used when detailed information about a specific category is needed, such as during data discovery processes, access governance reviews, or when setting up data lineage mappings. it does not modify any data and is primarily for information retrieval purposes.

Action Parameters

categoryLabel
stringRequired

Action Response

data
object
successful
boolean
error

The listassets endpoint retrieves a customized list of assets from borneo. it supports flexible filtering and sorting, enabling efficient asset management. use this endpoint for generating reports, conducting audits, or searching specific items. while powerful, it may not provide detailed asset information in the initial response.

Action Parameters

nextToken
string
maxResults
integer
filter__search
string
filter__type
array
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Lists the editions of a specific dashboard report in the borneo integration platform. this endpoint allows users to retrieve a paginated list of dashboard report editions, with options for sorting and specifying the number of results per page. it’s particularly useful for managing and reviewing multiple versions or iterations of a dashboard report, enabling users to track changes over time or select specific editions for further analysis or comparison. the endpoint supports efficient navigation through large sets of editions using pagination tokens and customizable sorting, making it suitable for applications that need to display or process dashboard report history.

Action Parameters

dashboardReportId
stringRequired
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Deletes a specific domain from the borneo integration platform. this endpoint permanently removes all data and configurations associated with the specified domain. use this operation with caution, as it cannot be undone. it should be used when a domain is no longer needed or when cleaning up unused resources. this operation may have cascading effects on related integrations or workflows, so ensure all dependencies are considered before deletion. the api will likely require appropriate authentication and authorization to perform this sensitive operation.

Action Parameters

domainId
stringRequired

Action Response

data
object
successful
boolean
error

The exportrecipientslist endpoint generates and exports a list of recipients based on specified criteria. it allows for flexible data extraction in multiple formats (csv, pdf, or doc) with extensive filtering options. this endpoint is ideal for generating reports, performing data analysis, or creating backups of recipient information. it can handle complex queries to narrow down the recipient list based on various attributes such as categories, roles, processing activities, and more. however, it does not provide real-time updates and should be used for point-in-time exports rather than live data access. the endpoint is particularly useful for compliance reporting, auditing, or transferring recipient data to other systems.

Action Parameters

exportTypes
arrayRequired
filter__search
string
filter__discoverySource
array
filter__categories
array
filter__role
array
filter__usedIn
object
filter__recipientIds
array
filter__subProcessorIds
array
filter__automationStatus
array
filter__withNoProcessingActivity
boolean
filter__departments
array
filter__status
string
filter__recipientWarranties
array
filter__recipientState
array

Action Response

data
object
successful
boolean
error

Retrieves a specific edition of a dashboard report from the borneo integration platform. this endpoint is used to fetch detailed information about a particular version of a report, allowing users to access historical data or compare different iterations of the same report. it’s particularly useful for tracking changes in business event impacts over time or analyzing data from specific periods. the endpoint should be used when there’s a need to review or analyze a specific report edition, rather than just the most recent data. it may not provide real-time updates and is limited to retrieving one report edition at a time.

Action Parameters

reportEditionId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific scan iteration in the borneo integration platform. this endpoint allows users to fetch the current status, results, and metadata associated with a particular scan iteration. it should be used when monitoring the progress of a scan, analyzing results, or troubleshooting integration workflows. the endpoint provides a snapshot of the scan iteration at the time of the request and may not reflect real-time updates if the scan is still in progress. it’s particularly useful for auditing, reporting, and maintaining a history of scan operations within borneo’s automation and integration processes.

Action Parameters

scanIterationId
stringRequired

Action Response

data
object
successful
boolean
error

The listdiscoveredinfotypes endpoint retrieves discovered info types from borneo, supporting flexible querying, filtering, sorting, and pagination. it’s used for exploring sensitive information identified in your data ecosystem, aiding in data governance and compliance monitoring. the endpoint offers advanced filtering and efficient handling of large datasets.

Action Parameters

filter__search
string
filter__status
string
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The retrieveauditlogs endpoint fetches filtered audit logs from borneo. it offers extensive filtering options for precise log retrieval across various cloud platforms and system components. use it for investigations, troubleshooting, and compliance checks. supports pagination with a 10,000 entry limit per call.

Action Parameters

filter__search
string
filter__scanId
string
filter__connectorId
string
filter__dataPlaneId
string
filter__accountId
string
filter__gcpConnectionId
string
filter__gcpProjectId
string
filter__azureConnectionId
string
filter__azureSubscriptionId
string
filter__category
string
filter__start
string
filter__end
string
pageSize
integer
nextToken
string

Action Response

data
object
successful
boolean
error

Initiates a password reset process for a specified dashboard user in the borneo platform. this endpoint should be used when a user has forgotten their password or needs to change it for security reasons. it triggers the password reset mechanism, which typically involves sending a reset link or temporary password to the user’s registered email address. this tool does not actually change the password but starts the secure reset process. it’s important to note that this endpoint doesn’t return the new password or reset token directly for security reasons.

Action Parameters

username
stringRequired

Action Response

data
object
successful
boolean
error

The pausescan endpoint allows users to temporarily halt an ongoing scan process in the borneo integration platform. this tool is used to pause the scanning and analysis of sensitive data within connected systems or data streams. it’s particularly useful when you need to temporarily suspend data processing for maintenance, to manage system resources, or to address any issues that may have arisen during the scan. the endpoint should be used when there’s a need to interrupt a scan without completely terminating it, allowing for later resumption. it’s important to note that this action doesn’t delete or reset the scan progress; it simply suspends further processing until explicitly resumed. the pause operation is immediate, but any in-progress data processing may complete before the pause takes full effect.

Action Parameters

scanId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific data scan performed by borneo’s data risk remediation platform. this endpoint allows users to fetch the results and metadata of a particular scan, including identified sensitive data, compliance status, and any automated tagging applied. it should be used when you need to review the outcome of a specific scan, track the progress of ongoing scans, or audit historical scan data. the endpoint focuses solely on providing scan-related information and does not modify any data or trigger new scans.

Action Parameters

scanId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific headquarters registered in the borneo system. this endpoint allows users to access comprehensive data about an organization’s headquarters, which may include its location, data governance practices, compliance status, and security measures. it’s particularly useful for auditing purposes, reviewing data management strategies, or assessing the overall data security posture of a specific organizational unit. the endpoint should be used when detailed information about a particular headquarters is needed, especially in the context of data security and governance. it may not provide real-time operational data or information about other organizational units not classified as headquarters.

Action Parameters

headquarterId
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new employee record in the borneo integration platform. this endpoint allows you to add an employee to the system with various details such as personal information, job-related data, and organizational structure. it’s primarily used when onboarding new employees or updating the system with employee information from external sources. the endpoint captures both mandatory fields (name, surname, createdby) and optional fields for a comprehensive employee profile. it’s particularly useful for hr systems integration, allowing synchronization with external apis through the referenceid field. note that while it collects employment dates, it doesn’t automatically handle employee status changes or departures; these would likely require separate api calls or processes.

Action Parameters

name
stringRequired
surname
stringRequired
createdBy
stringRequired
position
string
nif
string
startDate
string
endDate
string
email
string
manager
string
department
string
referenceId
string

Action Response

data
object
successful
boolean
error

Retrieves or updates information about the currently authenticated user in the borneo dashboard. this endpoint is designed to provide or modify user-specific data within the context of the borneo integration platform’s dashboard. it should be used when the application needs to access or update the current user’s profile, preferences, or permissions. the endpoint relies on the existing authentication context to identify the user, eliminating the need for additional parameters. it’s important to note that this endpoint may not provide general user management functions and is specifically tailored for the authenticated user’s dashboard experience.

Action Parameters

Action Response

data
object
successful
boolean
error

Listprocessingactivities retrieves a list of processing activities with extensive filtering, sorting, and pagination. it’s ideal for auditing, reporting, or managing data processing activities. the endpoint supports complex querying via the ‘filter’ object and efficient pagination. while powerful for retrieval, it doesn’t modify records.

Action Parameters

filter__search
string
filter__departments
array
filter__assets
array
filter__owners
array
filter__status
array
filter__recipients
array
filter__dataTypes
array
filter__infotypes
array
filter__infotypeCategories
array
filter__employees
array
filter__dataSubjects
array
filter__dataSources
array
filter__languages
array
filter__companyRoles
array
filter__paAsDataSource
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Removes a specified user from the dashboard in the borneo integration platform. this endpoint should be used when you need to revoke a user’s access to the dashboard, typically during offboarding processes or when adjusting user permissions. the operation is irreversible, so use it with caution. it only removes the user from the dashboard and does not affect their overall account status in the borneo platform. this endpoint is particularly useful for administrators managing user access to specific dashboards within the system.

Action Parameters

username
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new recipient in the borneo integration platform. this endpoint is used to register and manage detailed information about entities that receive or process data within the system. it captures essential details for compliance with data protection regulations, including the recipient’s role, location, data storage information, and associated legal documents like data processing agreements (dpas). the endpoint is particularly useful for organizations managing complex data ecosystems with multiple partners, vendors, or internal departments. it should be used when onboarding new data recipients or updating existing recipient information to maintain accurate records for auditing and compliance purposes. note that while many fields are optional, providing comprehensive information enhances the system’s ability to manage data flow and compliance effectively.

Action Parameters

name
stringRequired
businessName
string
status
stringRequired
categories
array
role
array
country
string
state
string
dpa
string
dpaFiles
array
dpaStatus
string
recipientModelId
string
dataStorageLocation
arrayRequired
recipientWarranties
arrayRequired
fromDiscoveredRecipientId
string
createdAt
integer
updatedAt
integer
subProcessorIds
array
recipientState
string

Action Response

data
object
successful
boolean
error

Deletes an employee record from the borneo system using the specified employee id. this endpoint should be used when an employee leaves the organization or when their record needs to be permanently removed from the system. once deleted, the employee data cannot be recovered through the api, so use this endpoint with caution. it’s recommended to archive or backup employee data before deletion if retention is required for compliance or record-keeping purposes. this operation is final and irreversible within the borneo platform.

Action Parameters

employeeId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific domain within the borneo integration platform. this endpoint should be used when you need to access the current configuration, status, or other attributes of a particular domain. it provides a comprehensive view of the domain’s settings, which can be useful for auditing, troubleshooting, or gathering information for further operations. the endpoint does not modify any domain data and is safe for frequent use. however, it’s important to note that this endpoint only retrieves information for a single domain at a time and does not provide aggregated data across multiple domains.

Action Parameters

domainId
stringRequired

Action Response

data
object
successful
boolean
error

The exportpageinsight endpoint allows users to export filtered inspection results from a specific scan in the borneo integration platform. this tool is particularly useful for retrieving and analyzing detailed information about scanned pages, resources, and detected info types. it provides extensive filtering capabilities to customize the exported data according to various criteria such as resource types, user associations, file types, and detection confidence levels. the endpoint should be used when a comprehensive export of scan results is needed, especially for further analysis or reporting purposes. it’s important to note that while the filtering options are extensive, the performance may be affected when exporting large datasets with multiple complex filters applied simultaneously.

Action Parameters

scanId
stringRequired
filter__search
string
filter__scanId
string
filter__pageId
string
filter__resourceIds
array
filter__resourceType
string
filter__scanIterationId
string
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
filter__userEmails
array
filter__status
array
filter__fileExtension
array
filter__categories
array
filter__infotypeConfidence
array
detailed
boolean

Action Response

data
object
successful
boolean
error

This endpoint updates the status of a specific discovered document in the borneo integration platform. it is used as part of the workflow automation process to manage the lifecycle of documents within the system. the endpoint accepts a document id and a new status, allowing users to change how the document is treated in subsequent processes. this tool should be used when there’s a need to modify the processing state of a discovered document, such as marking it for deletion or indicating that it has been successfully added to the system. it’s important to note that this endpoint only updates the status and doesn’t perform any other operations on the document itself.

Action Parameters

discoveredDocumentId
stringRequired
status
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a list of dashboard reports from the borneo integration platform, allowing for filtered, paginated, and sorted results. this endpoint is useful for obtaining an overview of available reports, such as privacy operations dashboards, data discovery dashboards, and privacy ops data flow reports. it supports complex querying through its filter object, enabling users to search by name, type, and frequency. the endpoint facilitates efficient data retrieval through pagination and customizable sorting, making it ideal for applications that need to display or process large sets of report data. use this when you need to fetch multiple dashboard reports at once, especially when implementing report listing features or performing bulk operations on report data.

Action Parameters

filter__search
string
filter__type
array
filter__frequency
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Retrieves a specific data protection impact assessment (dpia) using its unique identifier. this endpoint is used to access detailed information about a particular dpia, which is crucial for understanding and managing privacy risks associated with data processing activities in borneo’s conservation and resource management efforts. it should be used when detailed information about a specific dpia is required, such as for reviewing, updating, or referencing the assessment. the endpoint does not provide a list of all dpias or create new ones; it is specifically for retrieving individual dpia records. users should ensure they have the correct dpia identifier before making the request, as incorrect identifiers will likely result in a “not found” error.

Action Parameters

dpiaId
stringRequired

Action Response

data
object
successful
boolean
error

The deletetags endpoint removes specified tags from resources in the borneo integration platform. it allows users to delete tags based on their key, and optionally, their value, from a set of resources defined either by a filter or a list of resource ids. this endpoint is useful for maintaining clean and organized resource tagging, especially when tags become obsolete or need to be updated en masse. it’s particularly helpful for bulk tag removal across multiple resources or resource types. however, users should exercise caution as tag deletion is irreversible and may affect resource management and organization within the borneo platform.

Action Parameters

tagKey
stringRequired
tagValue
string
tagResources
objectRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information for a specific employee within the borneo integration platform. this endpoint should be used when you need to access comprehensive data about an individual employee, such as their personal details, job information, or any other relevant data stored in the system. it’s particularly useful for displaying employee profiles, verifying employee information, or as part of more complex workflows that require up-to-date employee data. the endpoint returns a single employee record based on the provided employee id. note that this endpoint only retrieves data and does not modify any employee information. it should not be used for bulk data retrieval or when you need summarized information about multiple employees.

Action Parameters

employeeId
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new department in the borneo integration platform. this endpoint allows you to add a department to the system with support for multilingual information. it’s particularly useful when setting up the organizational structure within borneo or when expanding to new regions requiring localized department names. the endpoint should be used when you need to establish a new department entity that other parts of the system can reference. it’s important to note that this endpoint only creates the department and does not associate it with any specific workflows or integrations - those would need to be set up separately.

Action Parameters

name
string
translations
object

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific cloud account within the borneo integration platform. this endpoint should be used when you need to access or verify the configuration, status, or properties of a particular cloud account. it provides essential data for account management, such as associated services, integration status, and account-specific settings. this tool is particularly useful for administrators managing multiple cloud accounts or for auditing purposes. note that it only retrieves information and does not modify the account in any way. the endpoint may not provide sensitive information like access keys or full credential details for security reasons.

Action Parameters

cloudAccountId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a specific insight from the borneo platform based on its type and unique identifier. this endpoint is crucial for accessing detailed information about data observability, security, privacy, or compliance issues identified by borneo’s ml-powered classifiers. use this when you need to fetch comprehensive data about a particular finding, such as sensitive data trends, privacy violations, or security gaps. the endpoint provides focused, in-depth information about a single insight, making it ideal for detailed investigations or generating specific reports. it does not provide aggregated data or lists of multiple insights; for those purposes, you would need to use a different endpoint.

Action Parameters

id
stringRequired
type
stringRequired

Action Response

data
object
successful
boolean
error

Disables a specified user account in the borneo dashboard, preventing further access to the system. this endpoint should be used when an administrator needs to revoke a user’s access to the borneo integration platform, such as when an employee leaves the organization or their role changes. the operation is not reversible through this endpoint, so it should be used with caution. note that disabling a user does not delete their account or associated data; it only restricts their ability to log in and use the dashboard.

Action Parameters

username
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new domain within the borneo integration platform, allowing for automatic polling and management of connected systems or applications. this endpoint is used to set up a new integration point with a specific name and polling frequency. it should be used when establishing a new connection or integration within the borneo ecosystem. the endpoint is particularly useful for setting up automated data synchronization or workflow triggers between different business applications. it does not provide information about existing domains or modify existing ones; it is strictly for creating new domains.

Action Parameters

name
stringRequired
frequency
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific tom resource using its unique identifier. this endpoint is crucial for accessing individual tom data within the borneo integration platform. it should be used when you need to fetch comprehensive details about a particular tom, such as its configuration, status, or associated metadata. the endpoint is particularly useful for monitoring, updating, or troubleshooting specific tom instances in your integration workflows. note that this endpoint only provides information for a single tom and cannot be used to list or search multiple toms simultaneously.

Action Parameters

tomId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a comprehensive list of resources from borneo’s inventory. supports detailed filtering, sorting, and pagination for efficient resource management and analysis across multiple cloud providers. ideal for security auditing, compliance monitoring, and inventory management tasks.

Action Parameters

pageSize
integer
nextToken
string
select
array
sort__column
string
sort__order
string
filter__accountId
string
filter__region
string
filter__regions
array
filter__search
string
filter__resourceType
string
filter__resourceIds
array
filter__parentId
string
filter__firstSeen
object
filter__noOwner
boolean
filter__hasOwner
boolean
filter__hasPii
boolean
filter__dataRisks
array
filter__severityScore
array
filter__hideBorneoResources
boolean
filter__dataSourceCategories
array
filter__classification
array
filter__scannableResourceTypes
boolean
filter__resourceTags
array
include__childResourceStats__scans
boolean
include__childResourceStats__dataSize
boolean
include__violationMetrics
boolean
include__frameworkExceptionsCount
boolean

Action Response

data
object
successful
boolean
error

Retrieves the user profile information for a specific user in the borneo integration platform. this endpoint should be used when detailed information about a user’s profile is needed, such as for displaying user data, verifying user details, or performing user-related operations within the borneo ecosystem. the endpoint focuses on providing user-specific data while maintaining borneo’s emphasis on data security and privacy observability. it’s important to note that this endpoint only retrieves profile information and does not modify or delete user data. the response will likely include various user attributes, but the exact structure and fields are not specified in the given schema.

Action Parameters

userId
stringRequired

Action Response

data
object
successful
boolean
error

The list-filters endpoint retrieves a list of available filters for data insights, specifically focused on file extension filters. this tool is used to obtain filtering options for managing and analyzing data within borneo’s integration platform. it’s particularly useful when users need to understand or apply filters based on file types in their data streams or integration processes. the endpoint requires a specific scan id, suggesting that filters are contextual to particular data scans or integration jobs. currently, the tool is limited to listing file extension filters, which may be used for data categorization, processing, or compliance purposes in data integration workflows.

Action Parameters

scanId
string
filterType
string

Action Response

data
object
successful
boolean
error

Retrieves a list of employees based on specified filtering and sorting criteria. this endpoint allows for flexible querying of employee data, supporting both simple and complex search scenarios. it can be used to find employees by name, filter by departments, and sort the results based on various attributes. the endpoint is particularly useful for generating reports, populating employee directories, or performing data analysis on the workforce. it does not modify any employee data and is intended for read-only operations. note that the response structure and pagination details are not specified in the given schema, so additional documentation may be needed for handling large result sets.

Action Parameters

nextToken
string
pageSize
integer
filter__search
string
filter__department
array
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Marks specified reports as false positives within a given scan in the borneo platform. this endpoint is used to refine scan results by identifying and flagging reports that are determined to be false alarms. it helps in improving the accuracy of security scans and reducing noise in the results. the function takes a scan id and a list of report uuids to be marked as false positives. it should be used when security analysts or automated systems have reviewed scan results and identified certain findings as non-issues or false alarms. this action helps in training the system and improving future scan accuracy. note that this operation is likely irreversible, so care should be taken to ensure only genuinely false positive reports are marked.

Action Parameters

scanId
stringRequired
reports
array

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific issue in the borneo system. this endpoint should be used when you need to fetch comprehensive data about a particular issue, such as its current status, associated tasks, or related workflow information. it’s particularly useful for tracking the progress of data integration processes, workflow automation tasks, or privacy compliance issues. the endpoint returns a single issue’s details and does not provide a list or summary of multiple issues. note that the exact structure of the returned data is not specified in the given schema, so users should be prepared to handle various fields related to issue management in borneo’s context.

Action Parameters

issueId
stringRequired

Action Response

data
object
successful
boolean
error

Deletes a specific data protection impact assessment (dpia) from the borneo system. this endpoint should be used when a dpia is no longer needed or relevant, such as when a project has been completed or cancelled, or when the assessment needs to be removed due to policy changes. the operation is irreversible, so it should be used with caution. once deleted, the dpia and its associated data cannot be recovered through the api. this endpoint is part of borneo’s data privacy management features, allowing organizations to maintain an up-to-date repository of their dpias.

Action Parameters

dpiaId
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new dashboard user in the borneo integration platform with specified roles, organizational access, and authentication settings. this endpoint allows for granular control over user permissions across different organizations and departments within the borneo ecosystem. it supports integration with external identity providers (okta or gcp) for authentication. use this endpoint when onboarding new users or updating existing user permissions. note that while only the email is required, it’s recommended to provide comprehensive role and organization information for proper access control.

Action Parameters

email
stringRequired
roles
array
organisations
array
name
string
filter__type
string
filter__id
string

Action Response

data
object
successful
boolean
error

The updatedatabreach endpoint allows users to create or update detailed information about a specific data breach incident in the borneo integration platform. this endpoint is crucial for maintaining accurate and comprehensive records of data breach incidents, which is essential for compliance, risk management, and improving security measures. the endpoint captures a wide range of information about the data breach, including its occurrence, discovery, affected parties, potential consequences, and measures taken in response. it provides flexibility by allowing users to save the information as a draft or finalize the report. this endpoint should be used when there’s a need to document a new data breach or update existing information about a breach. it’s particularly useful for security teams, compliance officers, and risk management professionals who need to maintain detailed records of security incidents.

Action Parameters

dataBreachId
stringRequired
shortDescription
stringRequired
occurredAt
integer
discoveredAt
integer
description
string
howDiscovered
string
wasIntentional
string
kindOfData
string
profilePeopleAffected
string
consequences
string
affectedPeopleFrom
string
numberAffectedPeople
integer
securityMeasuresOrProtocols
string
measuresToPrevent
string
problemOfSecurityMeasures
string
peopleInformed
string
authoritiesInformed
string
additionalInformation
array
createdBy
string
compromisedSensitiveData
string
saveAsDraft
booleanRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific evaluated data breach incident. this endpoint should be used when you need to access comprehensive details about a particular data breach that has been assessed within the borneo platform. it provides insights into the nature, scope, and potential impact of the breach, which can be crucial for incident response, compliance reporting, and risk assessment. the tool is particularly useful for security teams, compliance officers, and data protection officers who need to review or report on specific data breach incidents. note that this endpoint only provides information about breaches that have already been evaluated and recorded in the system; it cannot be used to report new breaches or assess ongoing incidents.

Action Parameters

dataBreachId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves the lineage information for a specified resource within the borneo integration platform. this endpoint allows users to trace the data flow both upstream and downstream from a given resource, providing crucial insights into data provenance and impact analysis. it’s particularly useful for data governance, compliance tracking, and understanding data transformations within your integrated systems. the endpoint requires specifying the resource id and the depth of lineage to explore in both directions, enabling fine-grained control over the scope of the lineage query. use this when you need to understand the origin, transformations, and downstream effects of your data resources in borneo.

Action Parameters

filter__resourceId
string
filter__upstreamDepth
integer
filter__downstreamDepth
integer

Action Response

data
object
successful
boolean
error

This endpoint exports a filtered list of processing activities in specified formats and languages. it allows users to retrieve data about various data processing activities, which can be customized using multiple filter criteria. the export can be generated in csv, pdf, or doc formats, supporting multiple languages for localization. this tool is particularly useful for generating reports, conducting audits, or sharing processing activity information with stakeholders in their preferred format and language. note that at least one export format and a language must be specified for a successful request.

Action Parameters

exportTypes
arrayRequired
language
stringRequired
filter__processingActivityId
string
filter__status
array
filter__departments
array
filter__dataSubjects
array
filter__employees
array
filter__infotypes
array
filter__owners
array
filter__recipients
array
filter__search
string

Action Response

data
object
successful
boolean
error

Retrieves a list of discovered documents in the borneo integration platform, allowing for flexible querying, filtering, and sorting of results. this endpoint is used to fetch information about documents that have been discovered by the system, such as newly added files, deleted documents, or items with specific statuses. it supports pagination for handling large datasets and provides sorting capabilities to organize the results according to user preferences. use this endpoint when you need to review, monitor, or analyze the discovered documents within your borneo integration environment.

Action Parameters

filter__search
string
filter__status
string
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Retrieves and filters the resource status for a specific scan iteration in the borneo integration platform. this endpoint allows users to fetch detailed information about the status of resources associated with a particular scan, supporting pagination for large datasets and filtering by resource name. it’s particularly useful for monitoring the progress of scans, troubleshooting issues with specific resources, or gathering data for reporting purposes. the endpoint should be used when detailed status information about scan resources is required, especially when dealing with large-scale scans that may involve numerous resources. note that while it supports retrieving up to 10,000 records per call, for very large scans, multiple calls using the nexttoken may be necessary to retrieve all data.

Action Parameters

scanId
stringRequired
filter__name
string
nextToken
string
pageSize
integer

Action Response

data
object
successful
boolean
error

The listaccounts endpoint retrieves a filtered and sorted list of accounts from the borneo platform. it supports complex querying based on various criteria, offers pagination for large datasets, and allows custom sorting. while providing extensive filtering, it doesn’t return detailed account information or support real-time updates.

Action Parameters

filter__search
string
filter__type
string
filter__status
array
filter__accountId
array
filter__cloudAccountId
array
filter__activeStates
boolean
pageSize
integer
nextToken
string
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific connector in the borneo integration platform. this endpoint allows you to fetch the configuration, status, and other relevant details of a connector using its unique identifier. use this endpoint when you need to inspect or troubleshoot a particular connector’s settings or performance. it’s particularly useful for administrators or developers managing integrations within the borneo ecosystem. the endpoint will not modify any connector settings; it’s a read-only operation designed for information retrieval only.

Action Parameters

connectorId
stringRequired

Action Response

data
object
successful
boolean
error

The insightlistpost endpoint retrieves a list of inspection results from the borneo integration platform. it allows users to fetch either scan-level or page-level results based on specified criteria. this endpoint is particularly useful for analyzing data security and compliance across various resources and scans. it supports extensive filtering options, pagination for large result sets, and customizable sorting, making it ideal for generating comprehensive reports or conducting detailed investigations into data insights. the endpoint should be used when a detailed overview of inspection results is required, but it may not provide real-time updates for ongoing scans.

Action Parameters

type
stringRequired
filter__search
string
filter__scanId
string
filter__pageId
string
filter__resourceIds
array
filter__resourceType
string
filter__scanIterationId
string
filter__infoTypes__infoTypes
array
filter__infoTypes__ops
string
filter__userEmails
array
filter__status
array
filter__fileExtension
array
filter__categories
array
filter__infotypeConfidence
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

The listrecipients endpoint retrieves a paginated and filtered list of recipients from the borneo application. it allows for extensive customization of the query through sorting and filtering options, making it suitable for various recipient management and data integration tasks. the endpoint supports pagination for efficient handling of large datasets and provides detailed filtering capabilities to narrow down results based on multiple criteria such as categories, roles, status, and associated entities. this tool is ideal for generating reports, auditing recipient data, or populating user interfaces with recipient information. it should be used when a comprehensive view of recipients is needed, with the ability to apply complex filters and sort the results as required. the endpoint does not modify any data and is solely for retrieval purposes.

Action Parameters

nextToken
string
pageSize
integer
sort__column
string
sort__order
string
filter__search
string
filter__discoverySource
array
filter__categories
array
filter__role
array
filter__usedIn
object
filter__recipientIds
array
filter__subProcessorIds
array
filter__automationStatus
array
filter__withNoProcessingActivity
boolean
filter__departments
array
filter__status
string
filter__recipientWarranties
array
filter__recipientState
array

Action Response

data
object
successful
boolean
error

Updates an existing data protection impact assessment (dpia) in the borneo system. this endpoint allows for comprehensive modification of a dpia’s privacy framework, risk assessments (confidentiality, integrity, and availability), and associated metadata. it’s used to refine and complete a dpia throughout its lifecycle, from draft to activation. the tool supports detailed documentation of privacy principles, risk analyses, and mitigation measures. it’s particularly useful for privacy professionals and data protection officers managing complex data processing activities. note that activating a dpia requires filling in numerous mandatory fields, ensuring a thorough privacy impact assessment.

Action Parameters

dpiaId
stringRequired
privacyFramework__purposeLimitation
string
privacyFramework__dataMinimisation
string
privacyFramework__accuracy
string
privacyFramework__retention
boolean
privacyFramework__retentionComment
string
privacyFramework__transparency
string
privacyFramework__consent
string
privacyFramework__dataRightsExercised
string
privacyFramework__additionalComment
string
confidentiality__threats
array
confidentiality__threatsComment
string
confidentiality__impacts
array
confidentiality__impactsComment
string
confidentiality__riskSources
array
confidentiality__riskSourcesComment
string
confidentiality__implementedToms
array
confidentiality__implementedTomsComment
string
confidentiality__plannedToms
array
confidentiality__plannedTomsComment
string
confidentiality__baselineSeverity
string
confidentiality__baselineLikelihood
string
confidentiality__baselineComment
string
confidentiality__residualRiskSeverity
string
confidentiality__residualRiskLikelihood
string
confidentiality__residualRiskComment
string
integrity__threats
array
integrity__threatsComment
string
integrity__impacts
array
integrity__impactsComment
string
integrity__riskSources
array
integrity__riskSourcesComment
string
integrity__implementedToms
array
integrity__implementedTomsComment
string
integrity__plannedToms
array
integrity__plannedTomsComment
string
integrity__baselineSeverity
string
integrity__baselineLikelihood
string
integrity__baselineComment
string
integrity__residualRiskSeverity
string
integrity__residualRiskLikelihood
string
integrity__residualRiskComment
string
availability__threats
array
availability__threatsComment
string
availability__impacts
array
availability__impactsComment
string
availability__riskSources
array
availability__riskSourcesComment
string
availability__implementedToms
array
availability__implementedTomsComment
string
availability__plannedToms
array
availability__plannedTomsComment
string
availability__baselineSeverity
string
availability__baselineLikelihood
string
availability__baselineComment
string
availability__residualRiskSeverity
string
availability__residualRiskLikelihood
string
availability__residualRiskComment
string
additionalInformation
string
additionalInformationFiles
array
status
stringRequired
translations
object

Action Response

data
object
successful
boolean
error

Retrieves statistical information about resource classifications based on the specified filter criteria. this endpoint allows you to query classification data for resources in the borneo integration platform. use this when you need to analyze the distribution or frequency of specific classifications within your integrated data. the endpoint returns aggregated statistics, not individual resource details. it’s particularly useful for generating reports, monitoring classification trends, or validating the effectiveness of your classification processes within borneo.

Action Parameters

filter__classification
string

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific data breach incident using its unique identifier. this endpoint is crucial for investigating and managing data breaches within the borneo platform. it provides comprehensive details about the breach, which may include the date of occurrence, affected data types, potential impact, and current status of the breach. use this endpoint when you need in-depth information about a particular data breach for compliance reporting, incident response, or forensic analysis. the endpoint focuses solely on providing information and does not perform any actions or modifications related to the data breach.

Action Parameters

dataBreachId
stringRequired

Action Response

data
object
successful
boolean
error

Lists and filters dashboard users in the borneo integration platform based on specified criteria. this endpoint allows retrieval of user data filtered by roles, tenant, organization, and departments. it’s useful for user management, access control, and generating reports on user distribution across different organizational units. the endpoint supports complex queries by combining multiple filter criteria, enabling precise user data retrieval for various administrative and analytical purposes.

Action Parameters

filter__roles
array
filter__tenantId
string
filter__organisationId
integer
filter__departments
array

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific discovered document within the borneo system. this endpoint allows users to access metadata, content, or processing status of a document that has been ingested, processed, or otherwise managed by borneo’s document management capabilities. it should be used when detailed information about a particular document is needed, such as during workflow processing, auditing, or information retrieval tasks. the endpoint is particularly useful for tracking the lifecycle of a document within borneo’s ecosystem, from discovery to final processing or archival stages. note that this endpoint only provides information about a single document; for bulk operations or document listings, a different endpoint would be more appropriate.

Action Parameters

discoveredDocumentId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information for a specific account within the borneo integration platform. this endpoint should be used when you need to access comprehensive account data, including settings, permissions, integration configurations, and other relevant information associated with the account. it’s particularly useful for account management tasks, auditing, or when displaying account details in a user interface. the endpoint returns the most up-to-date information available for the specified account. note that this endpoint does not provide real-time data security or privacy observability information; for those features, you may need to use separate dedicated endpoints within the borneo api.

Action Parameters

accountId
stringRequired

Action Response

data
object
successful
boolean
error

Lists the available filters for recipients in the borneo integration platform based on the specified filter type. this endpoint allows users to retrieve either category-based or role-based filters, which can be used to manage and organize recipients for targeted data distribution or notification purposes. use this endpoint when you need to access the current set of filters available for recipient management, either by categories or roles. it provides a comprehensive list of filters but does not apply or modify any filters; it’s purely for retrieval purposes. this tool is particularly useful for administrators or integrators who need to understand the current filter structure before applying filters to recipients or setting up data distribution rules.

Action Parameters

filterType
stringRequired

Action Response

data
object
successful
boolean
error

The listscaniterations endpoint allows users to retrieve a paginated list of scan iterations with customizable filtering, sorting, and field selection options. this post request is ideal for querying and analyzing scan iteration data across multiple scans or resources. use it to fetch specific subsets of scan iterations, sort results based on various criteria, and control the amount of data returned in each api call. the endpoint supports efficient pagination for handling large datasets, making it suitable for both small-scale queries and extensive data analysis tasks. it’s particularly useful for monitoring scan progress, auditing scan history, or gathering insights across multiple scan iterations.

Action Parameters

filter__scanId
string
filter__resourceId
string
filter__scanIterationId
string
select
array
nextToken
string
pageSize
integer
sort__column
string
sort__order
string

Action Response

data
object
successful
boolean
error

Retrieves a specific dashboard report from the borneo integration platform. this endpoint allows users to access detailed analytics and reporting data for a particular dashboard, providing insights into data exchange, workflow automation, and potentially sensitive data breach information. it should be used when a user needs to view or analyze a specific report’s contents, such as performance metrics, data sharing statistics, or privacy incident details. the endpoint is particularly useful for generating up-to-date reports for monitoring and decision-making purposes. note that this endpoint only retrieves existing reports and does not generate new ones or modify report data.

Action Parameters

dashboardReportId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a list of available filter options for data breaches in the borneo platform. this endpoint allows users to obtain specific filter criteria based on either the owner of the data breach or its current status. it’s particularly useful for preparing dynamic filter options in user interfaces or for understanding the range of possible values when filtering data breaches. the endpoint should be called when setting up data breach management dashboards or when implementing search and filter functionality for data breach records. note that this endpoint only provides filter options and does not return actual data breach information.

Action Parameters

filterType
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new threshold for a specific data processing activity in the borneo integration platform. this endpoint is used to define and set various characteristics and risk factors associated with a data processing activity, which is crucial for privacy compliance and risk assessment. the threshold creation process captures detailed information about the nature, scope, and potential impact of data processing, allowing organizations to evaluate and manage privacy risks effectively. use this endpoint when setting up new data processing activities or updating the risk profile of existing ones. the created threshold can be in either ‘draft’ or ‘activated’ status, allowing for review before finalizing. note that while many parameters are optional, providing comprehensive information ensures a more accurate risk assessment.

Action Parameters

processingActivityId
stringRequired
comment
string
extensiveAutomatedEvaluationCharacteristics
boolean
largeScaleProcessingSensitiveData
boolean
monitoringPubliclyAccessibleAreas
boolean
blacklist
boolean
classifyingDataSubject
boolean
automatedDecisionMaking
boolean
systematicMonitoringDataSubject
boolean
processingConfidentialSensitiveData
boolean
largeScaleDataProcessing
boolean
matchingMergingRecordsInvolved
boolean
processingVulnerableDataSubject
boolean
innovativeTechnologiesUsed
boolean
preventDataSubjectsExercisingTheirRights
boolean
status
string
createdAt
integer
updatedAt
integer
translations
object

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific threshold setting in the borneo integration platform. this endpoint allows users to fetch the configuration and current status of a particular threshold, which may be used for monitoring, alerting, or controlling data flows between integrated systems. it should be used when detailed information about a known threshold is required, such as during system audits, troubleshooting, or when adjusting integration workflows. the endpoint will not modify the threshold settings; it is for retrieval purposes only. users should ensure they have the correct thresholdid before making the request, as invalid ids will likely result in error responses.

Action Parameters

thresholdId
stringRequired

Action Response

data
object
successful
boolean
error

Creates a new data protection impact assessment (dpia) for a specific processing activity in the borneo application. this endpoint allows users to comprehensively assess and document privacy risks associated with data processing, including confidentiality, integrity, and availability risks. it should be used when initiating a new dpia process or updating an existing one with detailed risk assessments and mitigation measures. the tool provides a structured approach to evaluating privacy concerns and ensuring compliance with data protection regulations. however, it does not automatically implement any risk mitigation measures; it only facilitates the assessment and documentation process.

Action Parameters

processingActivityId
stringRequired
privacyFramework__purposeLimitation
string
privacyFramework__dataMinimisation
string
privacyFramework__accuracy
string
privacyFramework__retention
boolean
privacyFramework__retentionComment
string
privacyFramework__transparency
string
privacyFramework__consent
string
privacyFramework__dataRightsExercised
string
privacyFramework__additionalComment
string
confidentiality__threats
array
confidentiality__threatsComment
string
confidentiality__impacts
array
confidentiality__impactsComment
string
confidentiality__riskSources
array
confidentiality__riskSourcesComment
string
confidentiality__implementedToms
array
confidentiality__implementedTomsComment
string
confidentiality__plannedToms
array
confidentiality__plannedTomsComment
string
confidentiality__baselineSeverity
string
confidentiality__baselineLikelihood
string
confidentiality__baselineComment
string
confidentiality__residualRiskSeverity
string
confidentiality__residualRiskLikelihood
string
confidentiality__residualRiskComment
string
integrity__threats
array
integrity__threatsComment
string
integrity__impacts
array
integrity__impactsComment
string
integrity__riskSources
array
integrity__riskSourcesComment
string
integrity__implementedToms
array
integrity__implementedTomsComment
string
integrity__plannedToms
array
integrity__plannedTomsComment
string
integrity__baselineSeverity
string
integrity__baselineLikelihood
string
integrity__baselineComment
string
integrity__residualRiskSeverity
string
integrity__residualRiskLikelihood
string
integrity__residualRiskComment
string
availability__threats
array
availability__threatsComment
string
availability__impacts
array
availability__impactsComment
string
availability__riskSources
array
availability__riskSourcesComment
string
availability__implementedToms
array
availability__implementedTomsComment
string
availability__plannedToms
array
availability__plannedTomsComment
string
availability__baselineSeverity
string
availability__baselineLikelihood
string
availability__baselineComment
string
availability__residualRiskSeverity
string
availability__residualRiskLikelihood
string
availability__residualRiskComment
string
additionalInformation
string
additionalInformationFiles
array
status
stringRequired
createdAt
integer
updatedAt
integer
translations
object

Action Response

data
object
successful
boolean
error

Updates the settings of an existing dashboard report in the borneo integration platform. this endpoint allows you to modify the recipients, roles, and frequency of a specific dashboard report. use this when you need to change who receives the report, adjust access permissions, or alter the schedule for report generation. the function is particularly useful for maintaining up-to-date distribution lists and ensuring that reports are generated and sent at the most appropriate intervals for your organization’s needs. note that this endpoint only updates the report settings and does not generate or send the report itself.

Action Parameters

dashboardReportId
stringRequired
recipientsEmail
array
externalEmail
array
roles
array
frequency
string

Action Response

data
object
successful
boolean
error

This endpoint allows you to initiate a poll operation or submit data for a specific domain within the borneo integration platform. it is used when you need to gather information, trigger a data collection process, or update the status of a particular domain identified by its unique domainid. the post method suggests that you’re sending data to the server, possibly to start a new poll, update an existing one, or submit responses to a poll. this endpoint should be used when interacting with domain-specific polling functionality in borneo, such as collecting integration status updates or triggering scheduled data synchronizations. it’s important to note that the exact behavior and data requirements may vary depending on the specific implementation and purpose of polling in your borneo setup.

Action Parameters

domainId
stringRequired

Action Response

data
object
successful
boolean
error

Completes the email verification process for a user account in the borneo integration platform. this endpoint is called when a user clicks on the verification link sent to their email address. it validates the provided verificationid and token to confirm the user’s email address. this is a crucial step in the user authentication workflow, ensuring that users have provided valid email addresses and helping to prevent unauthorized access. the endpoint should only be used once per verification attempt, as tokens are typically single-use and time-limited for security reasons. note that this endpoint doesn’t handle the initial request for email verification or resending verification emails; it’s specifically for completing the verification process.

Action Parameters

verificationId
stringRequired
token
stringRequired

Action Response

data
object
successful
boolean
error

Deletes a specific threshold from the borneo integration platform. this endpoint should be used when you need to remove a threshold that is no longer required for monitoring or alerting purposes within your integrations. it permanently removes the threshold configuration from the system, so use with caution. this operation cannot be undone, and once a threshold is deleted, any associated alerts or monitoring rules will cease to function. ensure that the threshold is no longer needed before deletion to avoid disrupting active monitoring processes.

Action Parameters

thresholdId
stringRequired

Action Response

data
object
successful
boolean
error

Updates the information of an existing recipient in the borneo integration platform. this endpoint allows you to modify various details of a recipient, including their name, business information, status, categories, roles, and data protection-related information. it’s used when you need to change or update any aspect of a recipient’s profile, such as updating their dpa status, changing their role, or modifying their data storage locations. this endpoint is particularly useful for maintaining up-to-date records of your business partners and ensuring compliance with data protection regulations. note that some fields are required and must be included in every update request, while others are optional and can be omitted if no changes are needed.

Action Parameters

recipientId
stringRequired
name
stringRequired
businessName
string
status
stringRequired
categories
array
role
array
country
string
state
string
dpa
string
dpaFiles
array
dpaStatus
string
dataStorageLocation
arrayRequired
recipientWarranties
arrayRequired
automationStatus
string
subProcessorIds
array
recipientState
string

Action Response

data
object
successful
boolean
error

Retrieves detailed information about a specific discovered infotype from the borneo platform. this endpoint is used to access the characteristics, classification, and metadata of a particular data type that has been identified and categorized during the data discovery process. it is particularly useful for understanding the nature of sensitive or important data within your organization’s systems. the endpoint should be used when you need to review or analyze the properties of a specific discovered infotype, such as its sensitivity level, applicable compliance rules, or prevalence in your data landscape. it does not modify or create new infotypes; it only provides read access to existing discovered infotype information.

Action Parameters

discoveredInfotypeId
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves column information for resources in the borneo integration platform. this endpoint allows users to fetch metadata about the structure of resources, including column names, data types, and potentially other attributes. it’s particularly useful when you need to understand the schema of available resources for integration purposes or data analysis. the endpoint returns a comprehensive list of columns across all accessible resources, enabling developers to plan data mappings, transformations, or queries effectively. note that while this endpoint provides structural information, it does not return the actual data contained within the columns.

Action Parameters

parentResourceId
stringRequired
searchKey
string
sourceType
string
resourceId
array
dataspace
array

Action Response

data
object
successful
boolean
error

Deletes a specific dashboard report from the borneo integration platform. this endpoint should be used when you need to permanently remove a dashboard report that is no longer needed or relevant. it’s important to note that this action is irreversible, and once a report is deleted, it cannot be recovered. use this endpoint with caution, ensuring that the report is no longer required before deletion. the endpoint does not return the deleted report data, so make sure to retrieve any necessary information before deletion if needed.

Action Parameters

dashboardReportId
stringRequired

Action Response

data
object
successful
boolean
error