Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Comp AI Evidence Forms 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: Evidence Forms
description: Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
paths:
/v1/evidence-forms:
get:
description: List structured evidence forms that collect recurring submissions for security, HR, IT, finance, and compliance workflows.
operationId: EvidenceFormsController_listForms_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: List evidence forms
tags:
- Evidence Forms
x-mint:
metadata:
title: List evidence forms | Comp AI API
sidebarTitle: List evidence forms
description: List structured evidence forms that collect recurring submissions for security, HR, IT, finance, and compliance workflows.
og:title: List evidence forms | Comp AI API
og:description: List structured evidence forms that collect recurring submissions for security, HR, IT, finance, and compliance workflows.
x-speakeasy-mcp:
name: list-forms
/v1/evidence-forms/statuses:
get:
description: Get submission statuses for all forms in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getFormStatuses_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get submission statuses for all forms
tags:
- Evidence Forms
x-mint:
metadata:
title: Get submission statuses for all forms | Comp AI API
sidebarTitle: Get submission statuses for all forms
description: Get submission statuses for all forms in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
og:title: Get submission statuses for all forms | Comp AI API
og:description: Get submission statuses for all forms in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
x-speakeasy-mcp:
name: get-form-statuses
/v1/evidence-forms/settings:
get:
description: Get document relevance settings in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getFormSettings_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get document relevance settings
tags:
- Evidence Forms
x-mint:
metadata:
title: Get document relevance settings | Comp AI API
sidebarTitle: Get document relevance settings
description: Get document relevance settings in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
og:title: Get document relevance settings | Comp AI API
og:description: Get document relevance settings in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
x-speakeasy-mcp:
name: get-form-settings
/v1/evidence-forms/{formType}/settings:
patch:
description: Update document relevance setting in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_updateFormSetting_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Update document relevance setting
tags:
- Evidence Forms
x-mint:
metadata:
title: Update document relevance setting | Comp AI API
sidebarTitle: Update document relevance setting
description: Update document relevance setting in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
og:title: Update document relevance setting | Comp AI API
og:description: Update document relevance setting in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
x-speakeasy-mcp:
name: update-form-setting
/v1/evidence-forms/my-submissions:
get:
description: Get current user submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getMySubmissions_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: query
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get current user submissions
tags:
- Evidence Forms
x-mint:
metadata:
title: Get current user submissions | Comp AI API
sidebarTitle: Get current user submissions
description: Get current user submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
og:title: Get current user submissions | Comp AI API
og:description: Get current user submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
x-speakeasy-mcp:
name: get-my-submissions
/v1/evidence-forms/my-submissions/pending-count:
get:
description: Get pending submission count for current user in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getPendingSubmissionCount_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get pending submission count for current user
tags:
- Evidence Forms
x-mint:
metadata:
title: Get pending submission count for current user | Comp AI API
sidebarTitle: Get pending submission count for current user
description: Get pending submission count for current user in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks.
og:title: Get pending submission count for current user | Comp AI API
og:description: Get pending submission count for current user in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks.
x-speakeasy-mcp:
name: get-pending-submission-count
/v1/evidence-forms/{formType}:
get:
description: Get form definition and submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getFormWithSubmissions_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
- name: search
required: true
in: query
schema:
type: string
- name: limit
required: true
in: query
schema:
type: string
- name: offset
required: true
in: query
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get form definition and submissions
tags:
- Evidence Forms
x-mint:
metadata:
title: Get form definition and submissions | Comp AI API
sidebarTitle: Get form definition and submissions
description: Get form definition and submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
og:title: Get form definition and submissions | Comp AI API
og:description: Get form definition and submissions in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document.
x-speakeasy-mcp:
name: get-form-with-submissions
/v1/evidence-forms/{formType}/submissions/{submissionId}:
get:
description: Get a single submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_getSubmission_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
- name: submissionId
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Get a single submission
tags:
- Evidence Forms
x-mint:
metadata:
title: Get a single submission | Comp AI API
sidebarTitle: Get a single submission
description: Get a single submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
og:title: Get a single submission | Comp AI API
og:description: Get a single submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
x-speakeasy-mcp:
name: get-submission
delete:
description: Delete a submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_deleteSubmission_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
- name: submissionId
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Delete a submission
tags:
- Evidence Forms
x-mint:
metadata:
title: Delete a submission | Comp AI API
sidebarTitle: Delete a submission
description: Delete a submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
og:title: Delete a submission | Comp AI API
og:description: Delete a submission in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
x-speakeasy-mcp:
name: delete-submission
/v1/evidence-forms/{formType}/submissions:
post:
description: Submit structured evidence responses and attachments for review against a compliance task or document requirement.
operationId: EvidenceFormsController_submitForm_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
responses:
'201':
description: ''
security:
- apikey: []
summary: Submit evidence form
tags:
- Evidence Forms
x-mint:
metadata:
title: Submit evidence form | Comp AI API
sidebarTitle: Submit evidence form
description: Submit structured evidence responses and attachments for review against a compliance task or document requirement.
og:title: Submit evidence form | Comp AI API
og:description: Submit structured evidence responses and attachments for review against a compliance task or document requirement.
x-speakeasy-mcp:
name: submit-form
/v1/evidence-forms/{formType}/upload-submission:
post:
description: Upload a PDF or image file and create a submission for the given form type, bypassing form-specific validation. Accepts session, API key, or service token auth. For API key / service token callers without an explicit user attribution, the.
operationId: EvidenceFormsController_uploadSubmission_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
responses:
'201':
description: ''
security:
- apikey: []
summary: Upload a file as an evidence submission
tags:
- Evidence Forms
x-mint:
metadata:
title: Upload a file as an evidence submission | Comp AI API
sidebarTitle: Upload a file as an evidence submission
description: Upload a PDF or image file and create a submission for the given form type, bypassing form-specific validation. Accepts session, API key, or service token.
og:title: Upload a file as an evidence submission | Comp AI API
og:description: Upload a PDF or image file and create a submission for the given form type, bypassing form-specific validation. Accepts session, API key, or service token.
x-speakeasy-mcp:
name: upload-submission
/v1/evidence-forms/{formType}/submissions/{submissionId}/review:
patch:
description: Approve or reject a submitted evidence form so task status and audit readiness reflect the latest review decision.
operationId: EvidenceFormsController_reviewSubmission_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
- name: submissionId
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Review evidence submission
tags:
- Evidence Forms
x-mint:
metadata:
title: Review evidence submission | Comp AI API
sidebarTitle: Review evidence submission
description: Approve or reject a submitted evidence form so task status and audit readiness reflect the latest review decision.
og:title: Review evidence submission | Comp AI API
og:description: Approve or reject a submitted evidence form so task status and audit readiness reflect the latest review decision.
x-speakeasy-mcp:
name: review-submission
/v1/evidence-forms/uploads:
post:
description: Upload evidence form file in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
operationId: EvidenceFormsController_uploadFile_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
responses:
'201':
description: ''
security:
- apikey: []
summary: Upload evidence form file
tags:
- Evidence Forms
x-mint:
metadata:
title: Upload evidence form file | Comp AI API
sidebarTitle: Upload evidence form file
description: Upload evidence form file in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
og:title: Upload evidence form file | Comp AI API
og:description: Upload evidence form file in Comp AI. Collect, review, upload, and export structured evidence submissions for compliance tasks and document requirements.
x-speakeasy-mcp:
name: upload-file
/v1/evidence-forms/{formType}/export.csv:
get:
description: Export evidence form submissions as CSV for auditor requests, offline review, or internal compliance reporting.
operationId: EvidenceFormsController_exportCsv_v1
parameters:
- name: X-Organization-Id
in: header
description: Organization ID (required for session auth, optional for API key auth)
required: false
schema:
type: string
- name: formType
required: true
in: path
schema:
type: string
responses:
'200':
description: ''
security:
- apikey: []
summary: Export evidence submissions
tags:
- Evidence Forms
x-mint:
metadata:
title: Export evidence submissions | Comp AI API
sidebarTitle: Export evidence submissions
description: Export evidence form submissions as CSV for auditor requests, offline review, or internal compliance reporting.
og:title: Export evidence submissions | Comp AI API
og:description: Export evidence form submissions as CSV for auditor requests, offline review, or internal compliance reporting.
x-speakeasy-mcp:
name: export-csv
components:
securitySchemes:
apikey:
type: apiKey
in: header
name: X-API-Key
description: API key for authentication
x-speakeasy-timeout: 120000