Access Control - Users

Get Access Control users.

Retrieves a list of users and their permissions.

SecurityApiKeyAuth

Responses

200

get/access_control/users

Request samples

curl

Response samples

application/json

[{"user_id": 123,
"account_id": 123,
"permissions": {"WorkflowProject": [{"operation": "view"
}
],
"WorkflowProjectLevel": [{"operation": "view",
"name": "my_wf"
}
],
"WorkflowRestrictedOperators": [{"operation": "edit"
}
],
"Segmentation": [{"operation": "full"
}
],
"MasterSegmentConfigs": [{"operation": "view"
}
],
"MasterSegmentConfig": [{"operation": "view",
"id": "42"
}
],
"MasterSegmentColumn": [{"operation": "view_clear",
"column_identifiers": "1$attribute.customers.age,1$attribute.customers.first_name"
}
],
"MasterSegmentAllColumns": [{"operation": "view_clear",
"audience_id": "1"
}
],
"CookieConsent": [{"operation": "view"
}
],
"SegmentAllFolders": [{"operation": "view",
"audience_id": "42"
}
],
"SegmentFolder": [{"operation": "view",
"id": "42"
}
],
"Profiles": [{"operation": "view",
"audience_id": "42"
}
],
"ProfilesApiToken": [{"operation": "full",
"audience_id": "42"
}
],
"ActivationTemplate": [{"operation": "view"
}
],
"Activation": [{"operation": "create_only_with_template"
}
],
"Authentications": [{"operation": "use_limited",
"ids": "1,2,3"
}
],
"Sources": [{"operation": "restricted"
}
],
"Destinations": [{"operation": "restricted"
}
],
"Databases": [{"operation": "query",
"ids": "1,2,3"
}
],
"UniversalConsent": [{"operation": "full"
}
],
"TrafficControls": [{"operation": "full"
}
],
"TrafficControl": [{"operation": "full",
"audience_id": "42"
}
],
"Journeys": [{"operation": "full"
}
],
"Journey": [{"operation": "full",
"audience_id": "42"
}
],
"LlmProject": [{"operation": "full",
"project_id": "1"
}
]
},
"policies": [{"id": 67,
"account_id": 123,
"name": "some_policy",
"description": "written about the policy",
"user_count": 3
}
]
}
]

Get Access Control User

Retrieves the specified user.

SecurityApiKeyAuth

Request

path Parameters

user_id

required

integer (UserId)

Example: 123

Responses

200

get/access_control/users/{user_id}

Request samples

curl

Response samples

application/json

{"user_id": 123,
"account_id": 123,
"permissions": {"WorkflowProject": [{"operation": "view"
}
],
"WorkflowProjectLevel": [{"operation": "view",
"name": "my_wf"
}
],
"WorkflowRestrictedOperators": [{"operation": "edit"
}
],
"Segmentation": [{"operation": "full"
}
],
"MasterSegmentConfigs": [{"operation": "view"
}
],
"MasterSegmentConfig": [{"operation": "view",
"id": "42"
}
],
"MasterSegmentColumn": [{"operation": "view_clear",
"column_identifiers": "1$attribute.customers.age,1$attribute.customers.first_name"
}
],
"MasterSegmentAllColumns": [{"operation": "view_clear",
"audience_id": "1"
}
],
"CookieConsent": [{"operation": "view"
}
],
"SegmentAllFolders": [{"operation": "view",
"audience_id": "42"
}
],
"SegmentFolder": [{"operation": "view",
"id": "42"
}
],
"Profiles": [{"operation": "view",
"audience_id": "42"
}
],
"ProfilesApiToken": [{"operation": "full",
"audience_id": "42"
}
],
"ActivationTemplate": [{"operation": "view"
}
],
"Activation": [{"operation": "create_only_with_template"
}
],
"Authentications": [{"operation": "use_limited",
"ids": "1,2,3"
}
],
"Sources": [{"operation": "restricted"
}
],
"Destinations": [{"operation": "restricted"
}
],
"Databases": [{"operation": "query",
"ids": "1,2,3"
}
],
"UniversalConsent": [{"operation": "full"
}
],
"TrafficControls": [{"operation": "full"
}
],
"TrafficControl": [{"operation": "full",
"audience_id": "42"
}
],
"Journeys": [{"operation": "full"
}
],
"Journey": [{"operation": "full",
"audience_id": "42"
}
],
"LlmProject": [{"operation": "full",
"project_id": "1"
}
]
},
"policies": [{"id": 67,
"account_id": 123,
"name": "some_policy",
"description": "written about the policy",
"user_count": 3
}
]
}

Update Access Control User Permissions

Updates a user's permissions.

SecurityApiKeyAuth

Request

path Parameters

user_id

required

integer (UserId)

Example: 123

Request Body schema: application/json

	Array of objects Permissions on resource
	Array of objects Permissions on resource
	Array of objects Permissions on resource
	Array of objects Permissions on resource
	Array of objects Permissions on resource
	Array of objects Permissions on resource
	Array of objects Permissions on ActivationTemplate
	Array of objects Permissions on Activation

Responses

200

patch/access_control/users/{user_id}/permissions

Request samples

Payload
curl

application/json

{"WorkflowProject": [{"operation": "view"
}
],
"Segmentation": [{"operation": "full"
}
],
"MasterSegmentConfigs": [{"operation": "view"
}
],
"MasterSegmentConfig": [{"operation": "view",
"id": "42"
}
],
"SegmentAllFolders": [{"operation": "view",
"audience_id": "42"
}
],
"SegmentFolder": [{"operation": "view",
"id": "42"
}
],
"ActivationTemplate": [{"operation": "view"
}
],
"Activation": [{"operation": "create_only_with_template"
}
]
}

Response samples

application/json

{"user_id": 123,
"permissions": {"WorkflowProject": [{"operation": "view"
}
],
"Segmentation": [{"operation": "full"
}
],
"MasterSegmentConfigs": [{"operation": "view"
}
],
"MasterSegmentConfig": [{"operation": "view",
"id": "42"
}
],
"SegmentAllFolders": [{"operation": "view",
"audience_id": "42"
}
],
"SegmentFolder": [{"operation": "view",
"id": "42"
}
],
"ActivationTemplate": [{"operation": "view"
}
],
"Activation": [{"operation": "create_only_with_template"
}
]
}
}

Get Policy users

Retrieves a list of users attached to a policy.

SecurityApiKeyAuth

Request

path Parameters

policy_id

required

integer (AccessControlPolicyId)

Example: 67

Responses

200

get/access_control/policies/{policy_id}/users

Request samples

curl

Response samples

application/json

[{"user_id": 123,
"account_id": 123,
"email": "td@example.com",
"name": "Treasure Data"
}
]

Update Policy Users

Updates users attached to a policy.

SecurityApiKeyAuth

Request

path Parameters

policy_id

required

integer (AccessControlPolicyId)

Example: 67

Request Body schema: application/json

user_ids

required

Array of integers (UserId)

Responses

200

patch/access_control/policies/{policy_id}/users

Request samples

Payload
curl

application/json

{"user_ids": [123
]
}

Response samples

application/json

[{"user_id": 123,
"account_id": 123,
"permissions": {"WorkflowProject": [{"operation": "view"
}
],
"WorkflowProjectLevel": [{"operation": "view",
"name": "my_wf"
}
],
"WorkflowRestrictedOperators": [{"operation": "edit"
}
],
"Segmentation": [{"operation": "full"
}
],
"MasterSegmentConfigs": [{"operation": "view"
}
],
"MasterSegmentConfig": [{"operation": "view",
"id": "42"
}
],
"MasterSegmentColumn": [{"operation": "view_clear",
"column_identifiers": "1$attribute.customers.age,1$attribute.customers.first_name"
}
],
"MasterSegmentAllColumns": [{"operation": "view_clear",
"audience_id": "1"
}
],
"CookieConsent": [{"operation": "view"
}
],
"SegmentAllFolders": [{"operation": "view",
"audience_id": "42"
}
],
"SegmentFolder": [{"operation": "view",
"id": "42"
}
],
"Profiles": [{"operation": "view",
"audience_id": "42"
}
],
"ProfilesApiToken": [{"operation": "full",
"audience_id": "42"
}
],
"ActivationTemplate": [{"operation": "view"
}
],
"Activation": [{"operation": "create_only_with_template"
}
],
"Authentications": [{"operation": "use_limited",
"ids": "1,2,3"
}
],
"Sources": [{"operation": "restricted"
}
],
"Destinations": [{"operation": "restricted"
}
],
"Databases": [{"operation": "query",
"ids": "1,2,3"
}
],
"UniversalConsent": [{"operation": "full"
}
],
"TrafficControls": [{"operation": "full"
}
],
"TrafficControl": [{"operation": "full",
"audience_id": "42"
}
],
"Journeys": [{"operation": "full"
}
],
"Journey": [{"operation": "full",
"audience_id": "42"
}
],
"LlmProject": [{"operation": "full",
"project_id": "1"
}
]
},
"policies": [{"id": 67,
"account_id": 123,
"name": "some_policy",
"description": "written about the policy",
"user_count": 3
}
]
}
]