Audit Requests are the evidence requests that make up an Audit. Each request tracks its status, the Users assigned to it, and the evidence submitted against it.
Map controls to an Audit Request. Only Controls eligible for the audit are attached (in scope, in the audit's workspace, and in the audit's framework or a custom framework); every other requested ID is returned under skipped. Idempotent.
🧪 Note: This endpoint is in beta and may change.
🔒 Requires Audits: Map and Unmap Audit Request Controls permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "controlIds": [
- 1,
- 2
]
}{- "attached": [
- {
- "id": 1,
- "code": "DCF-1001",
- "name": "Vulnerability Management",
- "controlNumber": 1
}
], - "skipped": [
- {
- "controlId": 1,
- "reason": "NOT_ELIGIBLE"
}
]
}Unmap controls from an audit request. Idempotent — unmapping a control that is not mapped is a no-op, not a 404. Reconciles matching accepted DCF suggestions to rejected and marks the request's evidence package stale.
🧪 Note: This endpoint is in beta and may change.
🔒 Requires Audits: Map and Unmap Audit Request Controls permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "controlIds": [
- 1,
- 2
]
}{- "detached": [
- 10,
- 20
], - "skipped": [
- 30
]
}🧪 Note: This endpoint is in beta and may change.
🔒 Requires Customer Request: Get Customer Request permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "requestId": 1,
- "dcfCode": "DCF-1",
- "controlName": "Access Reviews",
- "controlDescription": "The organization performs quarterly access reviews.",
- "controlId": 1,
- "confidenceLevel": "HIGH",
- "rationale": "This control answers the request because it covers access governance.",
- "status": "PENDING",
- "acceptanceSource": "MANUAL",
- "decidedById": 1,
- "decidedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "pagination": {
- "cursor": "string"
}
}🧪 Note: This endpoint is in beta and may change.
🔒 Requires Customer Request: Get Customer Request permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "requestId": 1,
- "dcfCode": "DCF-1",
- "controlName": "Access Reviews",
- "controlDescription": "The organization performs quarterly access reviews.",
- "controlId": 1,
- "confidenceLevel": "HIGH",
- "rationale": "This control answers the request because it covers access governance.",
- "status": "PENDING",
- "acceptanceSource": "MANUAL",
- "decidedById": 1,
- "decidedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}🧪 Note: This endpoint is in beta and may change.
🔒 Requires Audits: Update Audit Request DCF Suggestions permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Unprocessable Entity
Internal server error
{- "action": "ACCEPT"
}{- "id": 1,
- "requestId": 1,
- "dcfCode": "DCF-1",
- "controlName": "Access Reviews",
- "controlDescription": "The organization performs quarterly access reviews.",
- "controlId": 1,
- "confidenceLevel": "HIGH",
- "rationale": "This control answers the request because it covers access governance.",
- "status": "PENDING",
- "acceptanceSource": "MANUAL",
- "decidedById": 1,
- "decidedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}🧪 Note: This endpoint is in beta and may change.
🔒 Requires Audits: Update Audit Request DCF Suggestions permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "requestIds": [
- 1,
- 2
], - "allRequests": false,
- "confidenceLevels": [
- "HIGH"
]
}{- "data": [
- {
- "requestId": 1,
- "acceptedCount": 3,
- "mappedCount": 3,
- "unresolvedCount": 0,
- "error": null
}
]
}Starts DCF suggestion generation for each audit request and returns without waiting for it to finish. Each row reports whether a run was STARTED, SKIPPED (a run is already in progress) or FAILED to start. To track progress, list the audit requests (GET .../audits/:auditId/requests) or get one (GET .../audits/:auditId/requests/:requestId) with expand[]=dcfSuggestionsSummary and read generationStatus, or get the audit (GET .../audits/:auditId) with the same expand and wait for requestsGeneratingCount to reach 0.
🧪 Note: This endpoint is in beta and may change.
🔒 Requires Audits: Update Audit Request DCF Suggestions permission.
Generation was requested; see each row for its outcome.
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "requestIds": [
- 1,
- 2
]
}{- "data": [
- {
- "requestId": 1,
- "status": "STARTED",
- "error": null
}
]
}🔒 Requires Customer Request: Get Customer Request permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "code": "REQ-001",
- "title": "Provide SOC 2 report",
- "description": "Please provide the latest SOC 2 Type II report.",
- "status": "OUTSTANDING",
- "auditId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "owners": [
- {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "messages": [
- {
- "id": 1,
- "message": "Please provide the latest SOC 2 report.",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "dcfSuggestionsSummary": {
- "generationStatus": "COMPLETED",
- "totalCount": 5,
- "pendingCount": 3,
- "acceptedCount": 2
}
}
], - "pagination": {
- "cursor": "string"
}
}🔒 Requires Customer Request: Get Customer Request permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "code": "REQ-001",
- "title": "Provide SOC 2 report",
- "description": "Please provide the latest SOC 2 Type II report.",
- "status": "OUTSTANDING",
- "auditId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "owners": [
- {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "messages": [
- {
- "id": 1,
- "message": "Please provide the latest SOC 2 report.",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "controls": [
- {
- "id": 1,
- "code": "DCF-1001",
- "name": "Vulnerability Management",
- "controlNumber": 1
}
], - "dcfSuggestionsSummary": {
- "generationStatus": "COMPLETED",
- "totalCount": 5,
- "pendingCount": 3,
- "acceptedCount": 2
}
}