Standard Connections let you integrate Drata with well-known third-party providers using Drata-defined credentials and data models, in contrast to Custom Connections, which use a user-defined schema.
Find AWS Connections matching the provided filters.
🔒 Requires AWS Connections: List AWS Connections permission.
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "clientAlias": "My AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "externalId": "b3b7f7b0-6e4b-4e2a-9c2f-3e2f6f8f1a1b",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a new AWS Connection by providing the ARN of an IAM Role for Drata to assume. The response includes the External ID to configure in the role's trust policy.
🔒 Requires AWS Connections: Create AWS Connection permission.
Created
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "My AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "externalId": "b3b7f7b0-6e4b-4e2a-9c2f-3e2f6f8f1a1b",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires AWS Connections: List AWS Connections permission.
required | number or string Drata internal numeric ID (e.g. |
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,
- "clientAlias": "My AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "externalId": "b3b7f7b0-6e4b-4e2a-9c2f-3e2f6f8f1a1b",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}Update an AWS Connection. Providing a new roleArn re-validates the connection via STS AssumeRole.
🔒 Requires AWS Connections: Update AWS Connection permission.
required | number or string Drata internal numeric ID (e.g. |
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
{- "name": "My Updated AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My AWS Connection",
- "roleArn": "arn:aws:iam::123456789012:role/DrataAuditRole",
- "externalId": "b3b7f7b0-6e4b-4e2a-9c2f-3e2f6f8f1a1b",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires AWS Connections: Delete AWS Connection permission.
required | number or string Drata internal numeric ID (e.g. |
No Content
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}
}Find Azure Connections matching the provided filters.
🔒 Requires Azure Connections: List Azure Connections permission.
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "clientAlias": "My Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a new Azure Connection using an Azure App Registration (Service Principal) and its client secret.
🔒 Requires Azure Connections: Create Azure Connection permission.
Created
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "My Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "applicationSecret": "abc123~ExampleClientSecretValue",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires Azure Connections: List Azure Connections permission.
required | number or string Drata internal numeric ID (e.g. |
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,
- "clientAlias": "My Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}Update an Azure Connection. Providing any new credential fields re-validates the connection.
🔒 Requires Azure Connections: Update Azure Connection permission.
required | number or string Drata internal numeric ID (e.g. |
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
{- "name": "My Updated Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "applicationSecret": "abc123~ExampleClientSecretValue",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My Azure Connection",
- "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
- "applicationId": "4f812b7c-91d4-4b3a-9c17-6e2d6d5f9f3a",
- "subscriptionId": "28ffcc9b-be6d-4bbf-b53a-057049debc38",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires Azure Connections: Delete Azure Connection permission.
required | number or string Drata internal numeric ID (e.g. |
No Content
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}
}Find GCP Connections matching the provided filters.
🔒 Requires GCP Connections: List GCP Connections permission.
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "clientAlias": "My GCP Connection",
- "projectId": "my-project",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a new GCP Connection by providing a GCP service account key. The service account must be granted read access to the resources Drata will scan.
🔒 Requires GCP Connections: Create GCP Connection permission.
Created
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "My GCP Connection",
- "serviceAccountKey": "{\"type\":\"service_account\",\"project_id\":\"my-project\",...}",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My GCP Connection",
- "projectId": "my-project",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires GCP Connections: List GCP Connections permission.
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,
- "clientAlias": "My GCP Connection",
- "projectId": "my-project",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}Update a GCP Connection. Providing a new serviceAccountKey re-validates the connection.
🔒 Requires GCP Connections: Update GCP Connection permission.
required | number or string Drata internal numeric ID (e.g. |
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
{- "name": "My Updated GCP Connection",
- "serviceAccountKey": "{\"type\":\"service_account\",\"project_id\":\"my-project\",...}",
- "workspaceIds": [
- 1
]
}{- "id": 1,
- "clientAlias": "My GCP Connection",
- "projectId": "my-project",
- "state": "ACTIVE",
- "createdById": 1,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "workspaces": [
- {
- "id": 1,
- "primary": false,
- "name": "Drata Automation",
- "description": "Drata automates SOC 2 compliance",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}🔒 Requires GCP Connections: Delete GCP Connection permission.
required | number or string Drata internal numeric ID (e.g. |
No Content
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}
}