# Comp AI Cloud Security API

**Canonical:** https://apis.io/apis/comp-ai/comp-ai-cloudsecurity-api/  
**Provider:** Comp AI — https://apis.io/providers/comp-ai/  
**Base URL:** https://api.trycomp.ai  
**Documentation:** https://api.trycomp.ai/docs

Comp AI Cloud Security API is one of 35 APIs that [Comp AI](https://apis.io/providers/comp-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Cloud Security. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Run AWS, Azure, and GCP cloud security scans, detect enabled services, review findings, and connect cloud posture results to compliance work.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/cloud-security/activity` | List recent cloud security activity |
| GET | `/v1/cloud-security/providers` | List supported cloud providers |
| GET | `/v1/cloud-security/findings` | List cloud security findings |
| POST | `/v1/cloud-security/findings/{findingId}/exception` | Mark a finding as an exception so it no longer appears in the active Scan… |
| PATCH | `/v1/cloud-security/connections/{connectionId}/scan-mode` | Switch the AWS scan engine for a connection (Comp AI scanners ↔ Security Hub) |
| DELETE | `/v1/cloud-security/exceptions/{exceptionId}` | Revoke an exception, reopening the finding |
| GET | `/v1/cloud-security/history` | List resolution, exception, and regression history for a connection |
| GET | `/v1/cloud-security/findings/{findingId}/check-definition` | Resolve the "About this check" description for a finding (AI-cached for AWS… |
| POST | `/v1/cloud-security/resolve-session/{connectionId}` | Resolve short-lived AWS credentials for a connection (internal only) |
| POST | `/v1/cloud-security/scan/{connectionId}` | Run cloud security scan |
| POST | `/v1/cloud-security/detect-services/{connectionId}` | Detect available cloud services for a connection |
| POST | `/v1/cloud-security/detect-gcp-org/{connectionId}` | Detect the GCP organization for a connection |
| POST | `/v1/cloud-security/select-gcp-projects/{connectionId}` | Select GCP projects for a connection |
| POST | `/v1/cloud-security/setup-gcp/{connectionId}` | Set up GCP for a connection |
| POST | `/v1/cloud-security/setup-gcp/{connectionId}/resolve-step` | Resolve a GCP setup step |
| POST | `/v1/cloud-security/setup-azure/{connectionId}` | Set up Azure for a connection |
| POST | `/v1/cloud-security/validate-azure/{connectionId}` | Validate Azure credentials for a connection |
| POST | `/v1/cloud-security/trigger/{connectionId}` | Trigger a cloud security run for a connection |
| GET | `/v1/cloud-security/runs/{runId}` | Get a cloud security scan run by ID |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/comp-ai/openapi/comp-ai-cloudsecurity-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-device-response-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-policy-response-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-create-risk-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-update-risk-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-update-policy-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/comp-ai/json-schema/comp-ai-create-vendor-dto-schema.json

## Other Comp AI APIs (12)

- [Comp AI Attachments API](https://apis.io/apis/comp-ai/comp-ai-attachments-api/)
- [Comp AI Audit Logs API](https://apis.io/apis/comp-ai/comp-ai-audit-logs-api/)
- [Comp AI Comments API](https://apis.io/apis/comp-ai/comp-ai-comments-api/)
- [Comp AI Context API](https://apis.io/apis/comp-ai/comp-ai-context-api/)
- [Comp AI Controls API](https://apis.io/apis/comp-ai/comp-ai-controls-api/)
- [Comp AI Device Agent API](https://apis.io/apis/comp-ai/comp-ai-device-agent-api/)
- [Comp AI Devices API](https://apis.io/apis/comp-ai/comp-ai-devices-api/)
- [Comp AI Evidence Export API](https://apis.io/apis/comp-ai/comp-ai-evidence-export-api/)
- [Comp AI Evidence Export (Auditor) API](https://apis.io/apis/comp-ai/comp-ai-evidence-export-auditor-api/)
- [Comp AI Evidence Forms API](https://apis.io/apis/comp-ai/comp-ai-evidence-forms-api/)
- [Comp AI Findings API](https://apis.io/apis/comp-ai/comp-ai-findings-api/)
- [Comp AI Frameworks API](https://apis.io/apis/comp-ai/comp-ai-frameworks-api/)

## Tags

Cloud Security

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/comp-ai/comp-ai-cloudsecurity-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/comp-ai/.