Control Tickets are remediation items in a connected ticket management system, linked to a Control so that the work closing a gap is recorded alongside the Control it affects.
List the remediation Tickets linked to a Control. Returns the state Drata holds; it does not call the connected system.
🔒 Requires Controls: List Control Tickets 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,
- "externalTicketId": "ENG-11245",
- "isDone": false,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectionId": 42,
- "lastSyncedAt": "2025-07-01T16:45:55.246Z",
- "completionDate": "2025-07-01T16:45:55.246Z"
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a new Ticket in a connected ticket management system and link it to a Control. Requires a Connection for the destination system; to attach a Ticket that already exists, link it instead.
🔒 Requires Ticket Management: Create Ticket permission.
Created
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
Third party system was unavailable
{- "connectionId": 42,
- "projectId": "10000",
- "issueTypeId": "10001",
- "listId": "10002",
- "teamId": "10003",
- "fields": [
- {
- "field": "summary",
- "type": "string",
- "value": "Enable MFA for the two remaining admin accounts"
}
], - "useRichContent": false
}{- "id": 1,
- "externalTicketId": "ENG-11245",
- "isDone": false,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectionId": 42,
- "lastSyncedAt": "2025-07-01T16:45:55.246Z",
- "completionDate": "2025-07-01T16:45:55.246Z"
}Link an existing Ticket to a Control by its URL. The provider is resolved from the URL, so a Connection for that provider must already exist.
🔒 Requires Controls: Link Control Ticket permission.
Created
Malformed data and/or validation errors
Invalid Authorization
You are not allowed to perform this action
Not Found
There is a conflict in the business rules with this request
You must accept the Drata terms and conditions to use the API
Internal server error
{
}{- "id": 1,
- "externalTicketId": "ENG-11245",
- "isDone": false,
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectionId": 42,
- "lastSyncedAt": "2025-07-01T16:45:55.246Z",
- "completionDate": "2025-07-01T16:45:55.246Z"
}Remove the association between a Ticket and a Control. The Ticket itself is not changed in the connected system.
🔒 Requires Controls: Unlink Control Ticket permission.
No Content
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": "string",
- "statusCode": 0,
- "message": "string",
- "code": 0
}