Edit control of the account

Edit control

Securitybearer
Request
path Parameters
controlId
required
number
workspaceId
required
number

The Workspace ID associated to the Account

Request Body schema: application/json
required
name
required
string <= 191 characters

The name of the control

description
required
string <= 30000 characters

The description of the control

question
string <= 768 characters

The question of the control

code
string <= 20 characters

The control code

activity
string <= 768 characters

The activity of the control

Responses
200
400

Malformed data and/or validation errors

401

Invalid Authorization

403

You are not allowed to perform this action

404

Record Not Found

500

Internal server error

default

Response Code: 412

You must accept the Drata terms and conditions to use the API

put/workspaces/{workspaceId}/controls/{controlId}
Request samples
application/json
{
  • "name": "Good Control Name",
  • "description": "A very good description",
  • "question": "A very good question",
  • "code": "DRA-69",
  • "activity": "A very good activity"
}
Response samples
application/json
{
  • "id": "123",
  • "name": "Databases Monitored and Alarmed",
  • "code": "DCF-1002",
  • "description": "Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on predetermined criteria. Incidents are escalated per policy.",
  • "question": "Does the organization implement tools to monitor its databases and notify appropriate personnel of incidents based on predetermined criteria?",
  • "activity": "1. Ensure tools are implemented to monitor databases",
  • "slug": "databases-monitored-and-alarmed",
  • "archivedAt": "2020-07-06 12:00:00.000000",
  • "lastUpdatedBy": "User",
  • "updatedAt": "2020-07-06 12:00:00.000000",
  • "fk_control_template_id": "123",
  • "hasEvidence": true,
  • "hasPolicy": true,
  • "isReady": "true",
  • "hasTicket": "true"
}