Skip to main content
Comp AI - Documentation home page
Search...
⌘K
Ask AI
Support
Get started
Get started
Search...
Navigation
Controls
Delete a control
Guides
Cloud Tests
Integrations
API
Join us on Discord
Organization
GET
Get organization information
DEL
Delete organization
PATCH
Update organization
GET
Get organization onboarding status
POST
Transfer organization ownership
GET
Get role notification settings
PUT
Update role notification settings
GET
List active API keys
POST
Create a new API key
GET
Get available API key scopes
GET
Get organization primary color
POST
Upload organization logo
DEL
Remove organization logo
POST
Revoke an API key
People
POST
Invite members to the organization
GET
Get all people
POST
Create a new member
GET
Get all employee devices with fleet compliance data
GET
Get integration test statistics grouped by assignee
POST
Add multiple members to organization
GET
Get members who can read a specific resource type
PATCH
Reactivate a deactivated member
GET
Get person by ID
DEL
Delete member
PATCH
Update member
GET
Get training video completions for a member
GET
Get fleet/device compliance for a member
DEL
Remove host (device) from Fleet
PATCH
Unlink device from member
GET
Get current user email notification preferences
PUT
Update current user email notification preferences
Risks
GET
Get all risks
POST
Create a new risk
GET
Get risk statistics grouped by assignee
GET
Get risk counts grouped by department
GET
Get risk by ID
DEL
Delete risk
PATCH
Update risk
Vendors
GET
Search global vendors database
GET
Get all vendors
POST
Create a new vendor
GET
Get vendor by ID
DEL
Delete vendor
PATCH
Update vendor
POST
Trigger vendor risk assessment
Context
GET
Get all context entries
POST
Create a new context entry
GET
Get context entry by ID
DEL
Delete context entry
PATCH
Update context entry
Devices
GET
Get all devices
GET
Get devices by member ID
Policies
GET
Get all policies
POST
Create a new policy
POST
Publish all draft policies
GET
Download all published policies as a single PDF
GET
Get mapped and all controls for a policy
POST
Map controls to a policy
POST
Regenerate policy content using AI
GET
Get a signed URL for the policy PDF
POST
Upload a PDF to a policy or version
DEL
Delete a policy PDF
GET
Get signed URL for policy PDF (alternate path)
DEL
Remove a control mapping from a policy
GET
Get policy by ID
DEL
Delete policy
PATCH
Update policy
GET
Get policy versions
POST
Create policy version
GET
Get policy version by ID
DEL
Delete policy version
PATCH
Update version content
POST
Publish new policy version
POST
Set active policy version
POST
Submit version for approval
POST
Accept pending policy changes and publish the version
POST
Deny pending policy changes
POST
Chat with AI about a policy
Attachments
GET
Get attachment download URL
Device Agent
POST
Exchange an auth code for device credentials
GET
Download a device-agent update
HEAD
Check a device-agent update's metadata
POST
Create a device-agent auth code
GET
List organizations for the current device
POST
Register a device agent
POST
Submit a device check-in
GET
Get device-agent status
GET
Download macOS Device Agent
GET
Download Windows Device Agent ZIP
Tasks
GET
Get all tasks
POST
Create a task
GET
Get task templates
DEL
Delete multiple tasks
PATCH
Update status for multiple tasks
PATCH
Update assignee for multiple tasks
PATCH
Reorder tasks
POST
Bulk submit tasks for review
GET
Get page options for tasks overview
GET
Get task by ID
DEL
Delete a task
PATCH
Update a task
GET
Get task activity
POST
Regenerate task from template
POST
Submit task for review
POST
Approve a task
POST
Reject a task review
GET
Get task attachments
POST
Upload attachment to task
GET
Get attachment download URL
DEL
Delete task attachment
Task Automations
GET
Get all automations for a task
POST
Create a new evidence automation
GET
Get automation details
DEL
Delete an automation
PATCH
Update an existing automation
GET
Get all runs for a specific automation
GET
Get all versions for an automation
POST
Create a published version record for an automation
GET
Get all automation runs for a task
Evidence Export
GET
Get task evidence summary
GET
Export automation evidence as PDF
GET
Export task evidence as ZIP
Evidence Export (Auditor)
GET
Export all organization evidence as ZIP (Auditor only)
Comments
GET
Get comments for an entity
POST
Create a new comment
PUT
Update a comment
DEL
Delete a comment
Health
GET
Health check
Trust Portal
GET
Get complete trust portal settings for admin page
POST
Upload a favicon for the trust portal
DEL
Remove the trust portal favicon
GET
Get domain verification status
POST
Upload or replace a compliance certificate (PDF only)
POST
Generate a temporary signed URL for a compliance certificate
POST
List uploaded compliance certificates for the organization
POST
Upload an additional trust portal document
POST
List additional trust portal documents for the organization
POST
Generate a temporary signed URL for a trust portal document
POST
Delete (deactivate) a trust portal document
PUT
Enable or disable the trust portal
POST
Add or update a custom domain for the trust portal
POST
Check DNS records for a custom domain
PUT
Update trust portal FAQs
PUT
Update allowed domains for the trust portal
PUT
Update trust portal framework settings
GET
Get trust portal overview
POST
Update trust portal overview section
GET
List custom links for trust portal
POST
Create a custom link for trust portal
POST
Update a custom link
POST
Delete a custom link
POST
Reorder custom links
POST
Update vendor trust portal settings
GET
List vendors configured for trust portal
Trust Access
POST
Submit data access request
GET
List access requests
GET
Get access request details
POST
Approve access request
POST
Deny access request
GET
List access grants
POST
Revoke access grant
POST
Resend access granted email
GET
Get NDA details by token
POST
Preview NDA by token
POST
Sign NDA
POST
Resend NDA email
POST
Preview NDA PDF
POST
Reclaim access
GET
Get grant data by access token
GET
List policies by access token
GET
Download all policies as watermarked PDF
GET
Download all policies as ZIP with individual PDFs
GET
List compliance resources by access token
GET
List additional documents by access token
GET
Download all additional documents as a ZIP by access token
GET
Download additional document by access token
GET
Download compliance resource by access token
GET
Get FAQs for a trust portal
GET
Get overview section for a trust portal
GET
Get custom links for a trust portal
GET
Get favicon URL for a trust portal
GET
Get vendors/subprocessors for a trust portal
Framework Editor Control Templates
GET
List control templates
POST
Create a control template
GET
Get a control template by ID
DEL
Delete a control template
PATCH
Update a control template
POST
Link a requirement to a control template
DEL
Unlink a requirement from a control template
POST
Link a policy template to a control template
DEL
Unlink a policy template from a control template
POST
Link a task template to a control template
DEL
Unlink a task template from a control template
Framework Editor Frameworks
GET
List frameworks
POST
Create a framework
GET
Get a framework by ID
DEL
Delete a framework
PATCH
Update a framework
POST
Import a framework definition
GET
Export a framework definition
GET
List controls for a framework
GET
List policy templates for a framework
GET
List task templates for a framework
GET
List documents for a framework
POST
Link a control to a framework
POST
Link a task template to a framework
POST
Link a policy template to a framework
Framework Editor Policy Templates
GET
List policy templates
POST
Create a policy template
GET
Get a policy template by ID
DEL
Delete a policy template
PATCH
Update a policy template
PATCH
Update policy template content
Framework Editor Requirements
GET
List requirements
POST
Create a requirement
DEL
Delete a requirement
PATCH
Update a requirement
Framework Editor Task Templates
GET
Get all framework editor task templates
POST
Create a framework editor task template
GET
Get framework editor task template by ID
DEL
Delete framework editor task template
PATCH
Update framework editor task template
Finding Templates
GET
Get all finding templates
POST
Create a finding template
GET
Get finding template by ID
DEL
Delete a finding template
PATCH
Update a finding template
Findings
GET
Get findings for a task
POST
Create a finding
GET
Get all findings for organization
GET
Get finding by ID
DEL
Delete a finding
PATCH
Update a finding
GET
Get finding history
Questionnaire
GET
List questionnaires
GET
Get a questionnaire by ID
DEL
Delete a questionnaire
POST
Parse an uploaded questionnaire file
POST
Answer a single questionnaire question
POST
Save a questionnaire answer
POST
Delete a questionnaire answer
POST
Export a questionnaire
POST
Upload and parse a questionnaire file
POST
Upload a questionnaire file and parse its questions
POST
Upload a questionnaire file and auto-answer with export
POST
Upload and auto-answer a questionnaire via trust portal token
POST
Export questionnaire answers
POST
Upload a questionnaire file and export auto-generated answers
POST
Auto-answer a questionnaire
Knowledge Base
GET
List all knowledge base documents for an organization
GET
List all manual answers for an organization
POST
Save or update a manual answer
POST
Upload a knowledge base document
POST
Get a signed download URL for a document
POST
Get a signed view URL for a document
POST
Delete a knowledge base document
POST
Trigger processing of knowledge base documents
POST
Create a public access token for a run
POST
Delete a manual answer
POST
Delete all manual answers for an organization
SOA
POST
Save a SOA answer
POST
Auto-fill SOA document
POST
Create a new SOA document
POST
Ensure SOA configuration and document exist
POST
Approve a SOA document
POST
Decline a SOA document
POST
Submit SOA document for approval
Integrations
GET
Check OAuth provider availability
POST
Start an OAuth authorization flow
GET
Handle OAuth provider callback
GET
List configured OAuth apps
POST
Create an OAuth app configuration
GET
Get OAuth app setup details
DEL
Delete an OAuth app configuration
GET
List available integration providers
GET
Get an integration provider by slug
GET
List integration connections
POST
Create an integration connection
GET
Get an integration connection by ID
DEL
Delete an integration connection
PATCH
Update an integration connection
POST
Test an integration connection
POST
Pause an integration connection
POST
Resume an integration connection
POST
Disconnect an integration
POST
Ensure valid credentials for a connection
GET
List services enabled on a connection
PUT
Set services enabled on a connection
PUT
Update integration credentials
GET
List check definitions for a provider
GET
List checks for a connection
POST
Run all checks for a connection
POST
Run a single check on a connection
GET
List variable definitions for a provider
GET
List connection variables
POST
Update connection variables
GET
Get options for a connection variable
GET
List checks for a task template
GET
List checks attached to a task
POST
Run a check for a task
POST
Disconnect checks from a task
POST
Reconnect checks to a task
GET
List check runs for a task
POST
Sync Google Workspace employees
POST
Get Google Workspace sync status
POST
Sync Rippling employees
POST
Get Rippling sync status
POST
Sync JumpCloud employees
POST
Get JumpCloud sync status
GET
Get the currently configured employee sync provider
POST
Set the employee sync provider
GET
List employee sync providers available to the org
POST
Sync employees for a dynamic provider
Webhook
POST
Receive a provider webhook event
CloudSecurity
GET
List recent cloud security activity
GET
List supported cloud providers
GET
List cloud security findings
POST
Trigger a security scan for a connection
POST
Detect available cloud services for a connection
POST
Detect the GCP organization for a connection
POST
Select GCP projects for a connection
POST
Set up GCP for a connection
POST
Resolve a GCP setup step
POST
Set up Azure for a connection
POST
Validate Azure credentials for a connection
POST
Trigger a cloud security run for a connection
GET
Get a cloud security scan run by ID
POST
Create a legacy cloud integration
POST
Validate legacy AWS credentials
DEL
Delete a legacy cloud integration
Remediation
GET
List remediation capabilities
POST
Preview a remediation
POST
Execute a remediation
POST
Roll back a remediation action
GET
List remediation actions
GET
Get the active remediation batch
POST
Create a remediation batch
PATCH
Update a remediation batch
POST
Skip a finding in a remediation batch
Browserbase
GET
Get organization browser context status
POST
Get or create organization browser context
POST
Create a new browser session
POST
Close a browser session
POST
Navigate to a URL
POST
Check authentication status
POST
Create a browser automation
GET
Get all browser automations for a task
GET
Get a browser automation by ID
DEL
Delete a browser automation
PATCH
Update a browser automation
POST
Start automation with live view
POST
Execute automation on existing session
POST
Run a browser automation
GET
Get run history for an automation
GET
Get a specific run by ID
Task Management
GET
Get task items statistics for an entity
GET
Get task items for an entity
POST
Create a new task item
PUT
Update a task item
DEL
Delete a task item
POST
Upload attachment to task item
DEL
Delete attachment from task item
GET
Get task item activity log
Assistant Chat
POST
Stream AI chat completion
GET
Get assistant chat history
PUT
Save assistant chat history
DEL
Clear assistant chat history
Roles
GET
List all roles
POST
Create a custom role
GET
Resolve permissions for custom roles
GET
Get a role by ID
DEL
Delete a custom role
PATCH
Update a custom role
Training
GET
Get training video completions for the authenticated user
POST
Mark a training video as complete
POST
Send training completion email with certificate
POST
Generate training completion certificate PDF
POST
Generate HIPAA training certificate PDF
Org Chart
GET
Get the organization chart
PUT
Create or update an interactive organization chart
DEL
Delete the organization chart
POST
Upload an image as the organization chart
Evidence Forms
GET
List evidence forms
GET
Get submission statuses for all forms
GET
Get current user submissions
GET
Get pending submission count for current user
GET
Get form definition and submissions
GET
Get a single submission
DEL
Delete a submission
POST
Submit evidence form entry
POST
Upload a file as an evidence submission
PATCH
Review a submission
POST
Upload evidence form file
GET
Export form submissions to CSV
Frameworks
GET
List framework instances for the organization
POST
Add frameworks to the organization
GET
List available frameworks (requires session, no active org needed — used during onboarding)
GET
Get overview compliance scores
GET
Get a single framework instance with full detail
DEL
Delete a framework instance
GET
Get a specific requirement with related controls
POST
Create a custom framework for this organization
POST
Add a custom requirement to a framework instance
POST
Link (clone) existing requirements from another framework into this one
POST
Link existing org controls to a requirement
Audit Logs
GET
Get audit logs filtered by entity type and ID
Controls
GET
List controls with relations
POST
Create a new control
GET
Get dropdown options for creating controls
GET
Get control detail with progress
DEL
Delete a control
POST
Link existing policies to a control
POST
Link existing tasks to a control
POST
Link existing requirements to a control
POST
Link required document types to a control
DEL
Remove a required document type from a control
Email - Unsubscribe
POST
One-click unsubscribe (RFC 8058)
Secrets
GET
List all secrets (metadata only, no values)
POST
Create a new secret
GET
Get a secret with decrypted value
PUT
Update a secret
DEL
Delete a secret
Security Penetration Tests
GET
List penetration test runs
POST
Create penetration test
GET
List accessible GitHub repositories
GET
Get penetration test status
GET
Get penetration test progress
GET
Get penetration test output
GET
Get penetration test PDF
POST
Receive penetration test webhook events
Pentest Billing
GET
Get pentest subscription status
POST
Create a Stripe checkout session for pentest subscription
POST
Handle Stripe checkout success callback
POST
Create a Stripe billing portal session
POST
Check and charge overage for a pentest run
Delete a control
cURL
curl --request DELETE \ --url http://localhost:3333/v1/controls/{id}
Controls
Delete a control
DELETE
/
v1
/
controls
/
{id}
Try it
Delete a control
cURL
curl --request DELETE \ --url http://localhost:3333/v1/controls/{id}
Path Parameters
id
string
required
Response
200 - undefined
Was this page helpful?
Yes
No
Get control detail with progress
Link existing policies to a control
⌘I
Assistant
Responses are generated using AI and may contain mistakes.