# Comp AI Policies API

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

Comp AI Policies 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 Policies. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Create, version, publish, export, map, and improve compliance policies with AI-assisted drafting and approval workflows.

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/policies` | List compliance policies |
| POST | `/v1/policies` | Create compliance policy |
| POST | `/v1/policies/publish-all` | Publish all draft policies |
| GET | `/v1/policies/download-all` | Download all published policies |
| GET | `/v1/policies/{id}/controls` | Get mapped and all controls for a policy |
| POST | `/v1/policies/{id}/controls` | Map controls to a policy |
| GET | `/v1/policies/{id}/evidence-tasks` | Get tasks that serve as evidence for a policy, grouped by control |
| POST | `/v1/policies/{id}/regenerate` | Regenerate policy with AI |
| GET | `/v1/policies/{id}/pdf/signed-url` | Get a signed URL for the policy PDF |
| POST | `/v1/policies/{id}/pdf` | Upload a PDF to a policy version (UI-only) |
| DELETE | `/v1/policies/{id}/pdf` | Delete a policy version PDF |
| POST | `/v1/policies/{id}/pdf/upload-url` | Request a presigned URL to upload a policy PDF |
| POST | `/v1/policies/{id}/pdf/confirm` | Confirm a policy PDF upload completed |
| GET | `/v1/policies/{id}/pdf-url` | Get signed URL for policy PDF (alternate path) |
| DELETE | `/v1/policies/{id}/controls/{controlId}` | Remove a control mapping from a policy |
| GET | `/v1/policies/{id}` | Get compliance policy |
| PATCH | `/v1/policies/{id}` | Update compliance policy |
| DELETE | `/v1/policies/{id}` | Delete compliance policy |
| GET | `/v1/policies/{id}/versions` | Get policy versions |
| POST | `/v1/policies/{id}/versions` | Create policy version |
| GET | `/v1/policies/{id}/versions/{versionId}` | Get policy version by ID |
| PATCH | `/v1/policies/{id}/versions/{versionId}` | Update version content |
| DELETE | `/v1/policies/{id}/versions/{versionId}` | Delete policy version |
| POST | `/v1/policies/{id}/versions/publish` | Publish policy version |
| POST | `/v1/policies/{id}/versions/{versionId}/activate` | Set active policy version |
| POST | `/v1/policies/{id}/versions/{versionId}/submit-for-approval` | Submit version for approval |
| POST | `/v1/policies/{id}/accept-changes` | Accept pending policy changes and publish the version |
| POST | `/v1/policies/{id}/deny-changes` | Deny pending policy changes |
| POST | `/v1/policies/{id}/ai-chat` | Chat with AI about a policy |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/comp-ai/openapi/comp-ai-policies-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 Cloud Security API](https://apis.io/apis/comp-ai/comp-ai-cloudsecurity-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/)

## Tags

Policies

---

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