Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Comp AI SOA 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: SOA
description: Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-group: Statement of Applicability
paths:
/v1/soa/save-answer:
post:
operationId: SOAController_saveAnswer_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SaveSOAAnswerDto'
responses:
'200':
description: Answer saved successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
security:
- apikey: []
summary: Save a SOA answer
tags:
- SOA
description: Save a SOA answer in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Save a SOA answer | Comp AI API
sidebarTitle: Save a SOA answer
description: Save a SOA answer in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Save a SOA answer | Comp AI API
og:description: Save a SOA answer in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: soa-save-answer
/v1/soa/auto-fill:
post:
description: Auto-fill a Statement of Applicability draft using organization context and framework mappings for ISO 27001 review.
operationId: SOAController_autoFill_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AutoFillSOADto'
responses:
'201':
description: ''
security:
- apikey: []
summary: Auto-fill ISO 27001 SOA
tags:
- SOA
x-mint:
metadata:
title: Auto-fill ISO 27001 SOA | Comp AI API
sidebarTitle: Auto-fill ISO 27001 SOA
description: Auto-fill a Statement of Applicability draft using organization context and framework mappings for ISO 27001 review.
og:title: Auto-fill ISO 27001 SOA | Comp AI API
og:description: Auto-fill a Statement of Applicability draft using organization context and framework mappings for ISO 27001 review.
x-speakeasy-mcp:
name: auto-fill
/v1/soa/create-document:
post:
operationId: SOAController_createDocument_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSOADocumentDto'
responses:
'200':
description: Document created successfully
security:
- apikey: []
summary: Create a new SOA document
tags:
- SOA
description: Create a new SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Create a new SOA document | Comp AI API
sidebarTitle: Create a new SOA document
description: Create a new SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Create a new SOA document | Comp AI API
og:description: Create a new SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: create-document
/v1/soa/ensure-setup:
post:
operationId: SOAController_ensureSetup_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EnsureSOASetupDto'
responses:
'200':
description: Setup ensured
security:
- apikey: []
summary: Ensure SOA configuration and document exist
tags:
- SOA
description: Ensure SOA configuration and document exist in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Ensure SOA configuration and document exist | Comp AI API
sidebarTitle: Ensure SOA configuration and document exist
description: Ensure SOA configuration and document exist in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Ensure SOA configuration and document exist | Comp AI API
og:description: Ensure SOA configuration and document exist in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: ensure-setup
/v1/soa/get-setup:
post:
operationId: SOAController_getSetup_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EnsureSOASetupDto'
responses:
'200':
description: Setup returned (configuration/document may be null)
security:
- apikey: []
summary: Read SOA configuration and document without creating either
tags:
- SOA
description: Read SOA configuration and document without creating either in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Read SOA configuration and document without | Comp AI API
sidebarTitle: Read SOA configuration and document without creating either
description: Read SOA configuration and document without creating either in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability.
og:title: Read SOA configuration and document without | Comp AI API
og:description: Read SOA configuration and document without creating either in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability.
x-speakeasy-mcp:
name: get-setup
/v1/soa/approve:
post:
operationId: SOAController_approveDocument_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ApproveSOADocumentDto'
responses:
'200':
description: Document approved successfully
security:
- apikey: []
summary: Approve a SOA document
tags:
- SOA
description: Approve a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Approve a SOA document | Comp AI API
sidebarTitle: Approve a SOA document
description: Approve a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Approve a SOA document | Comp AI API
og:description: Approve a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: approve-document
/v1/soa/decline:
post:
operationId: SOAController_declineDocument_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DeclineSOADocumentDto'
responses:
'200':
description: Document declined successfully
security:
- apikey: []
summary: Decline a SOA document
tags:
- SOA
description: Decline a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Decline a SOA document | Comp AI API
sidebarTitle: Decline a SOA document
description: Decline a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Decline a SOA document | Comp AI API
og:description: Decline a SOA document in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: decline-document
/v1/soa/submit-for-approval:
post:
operationId: SOAController_submitForApproval_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SubmitSOAForApprovalDto'
responses:
'200':
description: Document submitted for approval successfully
security:
- apikey: []
summary: Submit SOA document for approval
tags:
- SOA
description: Submit SOA document for approval in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-mint:
metadata:
title: Submit SOA document for approval | Comp AI API
sidebarTitle: Submit SOA document for approval
description: Submit SOA document for approval in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
og:title: Submit SOA document for approval | Comp AI API
og:description: Submit SOA document for approval in Comp AI. Create, auto-fill, review, approve, and export ISO 27001 Statement of Applicability documents.
x-speakeasy-mcp:
name: submit-for-approval
/v1/soa/export:
post:
operationId: SOAController_exportDocument_v1
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ExportSOADocumentDto'
responses:
'200':
description: Export SOA document to PDF
security:
- apikey: []
summary: Export ISO 27001 SOA
tags:
- SOA
description: Export the approved Statement of Applicability document for ISO 27001 auditors, customer reviews, and internal records.
x-mint:
metadata:
title: Export ISO 27001 SOA | Comp AI API
sidebarTitle: Export ISO 27001 SOA
description: Export the approved Statement of Applicability document for ISO 27001 auditors, customer reviews, and internal records.
og:title: Export ISO 27001 SOA | Comp AI API
og:description: Export the approved Statement of Applicability document for ISO 27001 auditors, customer reviews, and internal records.
x-speakeasy-mcp:
name: export-document
components:
schemas:
ApproveSOADocumentDto:
type: object
properties: {}
AutoFillSOADto:
type: object
properties: {}
SaveSOAAnswerDto:
type: object
properties: {}
CreateSOADocumentDto:
type: object
properties: {}
SubmitSOAForApprovalDto:
type: object
properties: {}
ExportSOADocumentDto:
type: object
properties: {}
DeclineSOADocumentDto:
type: object
properties: {}
EnsureSOASetupDto:
type: object
properties: {}
securitySchemes:
apikey:
type: apiKey
in: header
name: X-API-Key
description: API key for authentication
x-speakeasy-timeout: 120000