myOneTrustDeveloper ForumTechnology Partners
API Reference
Subscribe via RSS

Update Control

put
https://{hostname}/api/controls/v1/controls/

Use this API to update the attributes of a specific control in the Controls Library.

Path Params
uuid
required

ID of the control. This value is obtained using Get List of Controls API.

Body Params
string
required
length between 1 and 50

The identifier of the control.

string
required
length between 1 and 300

The name of the control.

uuid
required

The identifier of the organization the master control is linked to. In general, this is top organization in the org hierarchy.

string
length between 0 and 3000

Description of the control.

string
length between 0 and 500

The recommendation status of this control based on Athena logic.

uuid

Identifier of the framework the control is tied to.

string
length between 0 and 500

Name of the framework the control is tied to.

string
length between 0 and 500

Identifier used for translation of Framework Name.

string
enum

The new status of the control. This can be Active, Archived, or Pending.

Allowed:
uuid

The identifier of the category tied to the control. Optional if no category is needed or if category name is provided.

string
length between 0 and 500

The name of the category tied to the control. Optional if category Id is provided.

string
length between 0 and 500

Identifier used for translation of category name. Optional if category Id is provided.

attributes
object

Custom Attributes

string

Implementation guidance of control.

uuid

The identifier of the scope associated with this control.

justificationIds
array of uuids

Set of justification identifiers explaining why this control is included in the framework.

justificationIds
Responses

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Updated 29 days ago

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Choose an example:
application/json
*/*

Updated 29 days ago