How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Drata Policies API

A policy is a document that outlines an organization’s commitment to following standards relevant to its operations. The [help docs](https://help.drata.com/en/articles/9202419-policy-center-overview) have more information.

Drata Policies API is one of 52 APIs that Drata publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Policies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 14 operations across 8 paths, and defines 47 schemas. It is described by OpenAPI 3.2.0, at version V2.

Requests are made against 3 base URLs: https://public-api.drata.com/public/v2, https://public-api.eu.drata.com/public/v2, https://public-api.apac.drata.com/public/v2.

14 operations 8 paths 47 schemas 1 DELETE6 GET4 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
V2
Base URL
https://public-api.drata.com/public/v2
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Drata Policies API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API_KEY) (bearer).

Paths & Operations 14

Across 8 paths, the API surfaces 14 operations — 1 DELETE, 6 GET, 4 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Policies 14

A policy is a document that outlines an organization’s commitment to following standards relevant to its operations. The [help docs](https://help.drata.com/en/articles/9202419-pol…

GET
/policies
List Policies
PoliciesPublicV2Controller_listPolicies 10 params → 200400401403404412500
POST
/policies
Create Policy
PoliciesPublicV2Controller_createPolicy body → 201400401403404412500
GET
/policies/{policyId}/policy-versions
List Policy Versions
PoliciesPublicV2Controller_listPolicyVersions 10 params → 200400401403404412500
POST
/policies/{policyId}/policy-versions
Create Policy Version
PoliciesPublicV2Controller_createPolicyVersion 1 param body → 201400401403404412500
GET
/policies/{policyId}
Get Policy
PoliciesPublicV2Controller_getPolicy 2 params → 200400401403404412500
PUT
/policies/{policyId}
Modify Policy
PoliciesPublicV2Controller_modifyPolicy 1 param body → 200204400401403404412500
PUT
/policies/{policyId}/owner
Assign Policy Owner
PoliciesPublicV2Controller_assignPolicyOwner 1 param body → 204400401403404412500
GET
/policies/{policyId}/approval-configuration
Get Policy Approval Configuration
PoliciesPublicV2Controller_getApprovalConfiguration 1 param → 200401403404412500
POST
/policies/{policyId}/approval-configuration
Add Review Group Configuration
PoliciesPublicV2Controller_addPolicyApprovalConfiguration 1 param body → 201400401403412500
PUT
/policies/{policyId}/approval-configuration/{approvalConfigurationTier}
Update Review Group Configuration
PoliciesPublicV2Controller_updatePolicyApprovalConfiguration 2 params body → 200400401403404412500
DELETE
/policies/{policyId}/approval-configuration/{approvalConfigurationTier}
Remove Review Group Configuration
PoliciesPublicV2Controller_removePolicyApprovalConfiguration 2 params → 204400401403404412500
GET
/policies/{policyId}/actions
List Policy Actions
PoliciesPublicV2Controller_listPolicyActions 1 param → 200400401403404412500
POST
/policies/{policyId}/actions
Perform Policy Action
PoliciesPublicV2Controller_performPolicyAction 1 param body → 200400401403404412500
GET
/policies/{policyId}/policy-versions/{policyVersionId}
Get Policy Version
PoliciesPublicV2Controller_getPolicyVersion 3 params → 200

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are PolicyVersionResponsePublicV2Dto (23 properties), PolicyResponsePublicV2Dto (20 properties), CreatePolicyVersionRequestPublicV2Dto (12 properties), CreatePolicyRequestPublicV2Dto (12 properties). Each schema is shown below with its type and property counts.

PolicyVersionExpandEnum
string
CreatePolicyResponsePublicV2Dto
object
10 properties 10 required
ControlCompactResponsePublicV2Dto
object
7 properties 6 required
RenewalScheduleEnum
string
PolicyWeekTimeFrameSlaCompactResponsePublicV2Dto
object
5 properties 5 required
CreatePolicyRequestPublicV2Dto
object
12 properties 5 required
CreatePolicySourceTypeEnum
string
PolicyGracePeriodSlaCompactResponsePublicV2Dto
object
5 properties 5 required
ExceptionResponseDto
object
4 properties 3 required
PolicyActionResultResponsePublicV2Dto
object
3 properties 2 required
PolicyModifyRequestPublicV2Dto
object
9 properties
ConsensusRulePublicV2
string
PolicyActionsResponsePublicV2Dto
object
1 property 1 required
PolicyApprovalAction
string
UserCompactResponsePublicV2Dto
object
6 properties 6 required
PolicyResponsePublicV2Dto
object
20 properties 13 required
CreatePolicyVersionRequestPublicV2Dto
object
12 properties 4 required
PolicyStatusEnum
string
PolicyVersionsResponsePublicV2Dto
object
2 properties 2 required
SortDirectionEnum
string
PolicyP3MatrixSlaCompactResponsePublicV2Dto
object
5 properties 5 required
PoliciesResponsePublicV2Dto
object
2 properties 2 required
GroupCompactResponsePublicV2Dto
object
7 properties 6 required
PolicyVersionSummaryResponsePublicV2Dto
object
8 properties 8 required
PolicyApprovalConfigurationResponsePublicV2Dto
object
1 property 1 required
PolicyLanguageEnum
string
PolicyVersionHtmlResponsePublicV2Dto
object
1 property 1 required
PolicyVersionResponsePublicV2Dto
object
23 properties 14 required
ReviewStatusEnum
string
PolicyVersionLanguageCompactResponsePublicV2Dto
object
9 properties 9 required
PolicyOwnerModifyRequestPublicV2Dto
object
1 property 1 required
PolicyScopeEnum
string
ExceptionResponsePublicV2Dto
object
5 properties 4 required
PaginationTotalCountResponsePublicV2Dto
object
2 properties 1 required
PayloadSchemaResponsePublicV2Dto
object
4 properties 4 required
ReviewGroupResponsePublicV2Dto
object
5 properties 5 required
ReviewGroupRequestPublicV2Dto
object
4 properties 4 required
SortTypeLimitedEnum
string
PolicyActionItemResponsePublicV2Dto
object
4 properties 3 required
PolicyActionRequestPublicV2Dto
object
3 properties 1 required
ExceptionResponsePublicDto
object
4 properties 3 required
PolicyListExpandEnum
string
PolicyTypeEnum
string
PolicyCompactResponsePublicV2Dto
object
8 properties 7 required
PolicyExpandEnum
string
PolicyVersionStatusEnum
string
PolicyVersionListExpandEnum
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

drata-policies-api-openapi.yml Raw ↑

Other APIs Drata publishes across the network.

Drata MCP Server
Drata Account Members API
Drata Accounts API
Drata Assets API
Drata Audit Requests API
Drata Audits API
Drata Background Checks API
Drata Company API
Drata Control Library API
Drata Control Notes API
Drata Control Owners API
Drata Controls API
Where this information came from

This is an independent, third-party profile of Drata Policies API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.