Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Comp AI Device Agent API
description: Compliance automation API for SOC 2, ISO 27001, HIPAA, GDPR, evidence collection, policy workflows, Trust Access, security questionnaires, integrations, cloud checks, and device compliance.
version: '1.0'
contact: {}
servers:
- url: https://api.trycomp.ai
description: Production API Server
tags:
- name: Device Agent
description: Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
paths:
/v1/device-agent/exchange-code:
post:
operationId: DeviceAgentController_exchangeCode_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ExchangeCodeDto'
responses:
'201':
description: ''
summary: Exchange an auth code for device credentials
tags:
- Device Agent
description: Exchange an auth code for device credentials in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Exchange an auth code for device credentials | Comp AI API
sidebarTitle: Exchange an auth code for device credentials
description: Exchange an auth code for device credentials in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage.
og:title: Exchange an auth code for device credentials | Comp AI API
og:description: Exchange an auth code for device credentials in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage.
x-speakeasy-mcp:
name: exchange-code
/v1/device-agent/updates/{filename}:
get:
operationId: DeviceAgentController_getUpdateFile_v1
parameters:
- name: filename
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
summary: Download a device-agent update
tags:
- Device Agent
description: Download a device-agent update in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Download a device-agent update | Comp AI API
sidebarTitle: Download a device-agent update
description: Download a device-agent update in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
og:title: Download a device-agent update | Comp AI API
og:description: Download a device-agent update in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
x-speakeasy-mcp:
name: get-update-file
head:
operationId: DeviceAgentController_headUpdateFile_v1
parameters:
- name: filename
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
summary: Check a device-agent update's metadata
tags:
- Device Agent
description: Check a device-agent update's metadata in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Check a device-agent update's metadata | Comp AI API
sidebarTitle: Check a device-agent update's metadata
description: Check a device-agent update's metadata in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
og:title: Check a device-agent update's metadata | Comp AI API
og:description: Check a device-agent update's metadata in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
x-speakeasy-mcp:
name: head-update-file
/v1/device-agent/auth-code:
post:
operationId: DeviceAgentController_generateAuthCode_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AuthCodeDto'
responses:
'201':
description: ''
summary: Create a device-agent auth code
tags:
- Device Agent
description: Create a device-agent auth code in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Create a device-agent auth code | Comp AI API
sidebarTitle: Create a device-agent auth code
description: Create a device-agent auth code in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
og:title: Create a device-agent auth code | Comp AI API
og:description: Create a device-agent auth code in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint.
x-speakeasy-mcp:
name: generate-auth-code
/v1/device-agent/my-organizations:
get:
operationId: DeviceAgentController_getMyOrganizations_v1
parameters: []
responses:
'200':
description: ''
summary: List organizations for the current device
tags:
- Device Agent
description: List organizations for the current device in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: List organizations for the current device | Comp AI API
sidebarTitle: List organizations for the current device
description: List organizations for the current device in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage.
og:title: List organizations for the current device | Comp AI API
og:description: List organizations for the current device in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage.
x-speakeasy-mcp:
name: get-my-organizations
/v1/device-agent/register:
post:
operationId: DeviceAgentController_registerDevice_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RegisterDeviceDto'
responses:
'201':
description: ''
summary: Register device agent
tags:
- Device Agent
description: Register a Comp AI Device Agent installation so employee endpoint checks can report into compliance tasks and device inventory.
x-mint:
metadata:
title: Register device agent | Comp AI API
sidebarTitle: Register device agent
description: Register a Comp AI Device Agent installation so employee endpoint checks can report into compliance tasks and device inventory.
og:title: Register device agent | Comp AI API
og:description: Register a Comp AI Device Agent installation so employee endpoint checks can report into compliance tasks and device inventory.
x-speakeasy-mcp:
name: register-device
/v1/device-agent/check-in:
post:
operationId: DeviceAgentController_checkIn_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CheckInDto'
responses:
'201':
description: ''
summary: Submit device compliance check-in
tags:
- Device Agent
description: Submit device security check results for encryption, antivirus, password policy, screen lock, and other endpoint controls.
x-mint:
metadata:
title: Submit device compliance check-in | Comp AI API
sidebarTitle: Submit device compliance check-in
description: Submit device security check results for encryption, antivirus, password policy, screen lock, and other endpoint controls.
og:title: Submit device compliance check-in | Comp AI API
og:description: Submit device security check results for encryption, antivirus, password policy, screen lock, and other endpoint controls.
x-speakeasy-mcp:
name: check-in
/v1/device-agent/status:
get:
operationId: DeviceAgentController_getDeviceStatus_v1
parameters:
- name: deviceId
required: true
in: query
schema:
type: string
- name: organizationId
required: true
in: query
schema:
type: string
responses:
'200':
description: ''
summary: Get device-agent status
tags:
- Device Agent
description: Get device-agent status in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Get device-agent status | Comp AI API
sidebarTitle: Get device-agent status
description: Get device-agent status in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
og:title: Get device-agent status | Comp AI API
og:description: Get device-agent status in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-speakeasy-mcp:
name: get-device-status
/v1/device-agent/mac:
get:
description: Downloads the Comp AI Device Agent installer for macOS as a DMG file. The agent helps monitor device compliance and security policies.
operationId: DeviceAgentController_downloadMacAgent_v1
parameters: []
responses:
default:
description: 'Internal server error
macOS agent file not found in S3
Unauthorized - Invalid or missing authentication
macOS agent DMG file download'
content:
application/x-apple-diskimage:
schema:
type: string
format: binary
example: Binary DMG file content
headers:
Content-Disposition:
description: Indicates file should be downloaded with specific filename
schema:
type: string
example: attachment; filename="Comp AI Agent-1.0.0-arm64.dmg"
Content-Type:
description: MIME type for macOS disk image
schema:
type: string
example: application/x-apple-diskimage
security:
- apikey: []
summary: Download macOS Device Agent
tags:
- Device Agent
x-mint:
metadata:
title: Download macOS Device Agent | Comp AI API
sidebarTitle: Download macOS Device Agent
description: Downloads the Comp AI Device Agent installer for macOS as a DMG file. The agent helps monitor device compliance and security policies.
og:title: Download macOS Device Agent | Comp AI API
og:description: Downloads the Comp AI Device Agent installer for macOS as a DMG file. The agent helps monitor device compliance and security policies.
x-speakeasy-mcp:
name: download-mac-agent
/v1/device-agent/windows:
get:
description: Downloads a ZIP package containing the Comp AI Device Agent installer for Windows, along with setup scripts and instructions. The package includes an MSI installer, setup batch script customized for the organization and user, and a README.
operationId: DeviceAgentController_downloadWindowsAgent_v1
parameters: []
responses:
default:
description: 'Internal server error
Windows agent file not found in S3
Unauthorized - Invalid or missing authentication
Windows agent ZIP file download containing MSI installer and setup scripts'
content:
application/zip:
schema:
type: string
format: binary
example: Binary ZIP file content
headers:
Content-Disposition:
description: Indicates file should be downloaded with specific filename
schema:
type: string
example: attachment; filename="compai-device-agent-windows.zip"
Content-Type:
description: MIME type for ZIP archive
schema:
type: string
example: application/zip
security:
- apikey: []
summary: Download Windows Device Agent ZIP
tags:
- Device Agent
x-mint:
metadata:
title: Download Windows Device Agent ZIP | Comp AI API
sidebarTitle: Download Windows Device Agent ZIP
description: Downloads a ZIP package containing the Comp AI Device Agent installer for Windows, along with setup scripts and instructions. The package includes an MSI.
og:title: Download Windows Device Agent ZIP | Comp AI API
og:description: Downloads a ZIP package containing the Comp AI Device Agent installer for Windows, along with setup scripts and instructions. The package includes an MSI.
x-speakeasy-mcp:
name: download-windows-agent
/v1/device-agent/sessions/{deviceId}:
delete:
operationId: DeviceAgentController_revokeAgentAccess_v1
parameters:
- name: deviceId
required: true
in: path
schema:
type: string
responses:
'204':
description: ''
summary: Revoke a device agent session
tags:
- Device Agent
description: Revoke a device agent session in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security status.
x-mint:
metadata:
title: Revoke a device agent session | Comp AI API
sidebarTitle: Revoke a device agent session
description: Revoke a device agent session in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security.
og:title: Revoke a device agent session | Comp AI API
og:description: Revoke a device agent session in Comp AI. Register employee devices, submit device compliance check-ins, download agent builds, and manage endpoint security.
x-speakeasy-mcp:
name: revoke-agent-access
components:
schemas:
ExchangeCodeDto:
type: object
properties: {}
RegisterDeviceDto:
type: object
properties: {}
CheckInDto:
type: object
properties: {}
AuthCodeDto:
type: object
properties: {}
securitySchemes:
apikey:
type: apiKey
in: header
name: X-API-Key
description: API key for authentication
x-speakeasy-timeout: 120000