User Guide Getting Started Help Center Documentation Community Training
Looker
  
English
Français
Deutsch
日本語
Role : Manage Roles

Get Model Set

GET/api/3.0/model_sets/{model_set_id}
model_set(model_set_id, fields)

Implementation Notes

Get information about the model set with a specific id.

Response Class

ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
model_set_id true Id of model set integer int64
fields false Requested fields. string string

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Delete Model Set

DELETE/api/3.0/model_sets/{model_set_id}
delete_model_set(model_set_id)

Implementation Notes

Delete the model set with a specific id.

Response Class

  None

Parameters

Parameter Required? Description Parameter Type Data Type
model_set_id true id of model set integer int64

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
204 Model set succssfully deleted. string

Update Model Set

PATCH/api/3.0/model_sets/{model_set_id}
update_model_set(model_set_id, body)

Implementation Notes

Update information about the model set with a specific id.

Response Class

ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
model_set_id true id of model set integer int64
body true ModelSet body
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get All Model Sets

GET/api/3.0/model_sets
all_model_sets(fields)

Implementation Notes

Get information about all model sets.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
fields false Requested fields. string string

Response Messages

HTTP Status Code Reason Response Model
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Create Model Set

POST/api/3.0/model_sets
create_model_set(body)

Implementation Notes

Create a model set with the specified information. Model sets are used by Roles.

Response Class

ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
body false ModelSet body
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
409 Resource Already Exists
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get All Permissions

GET/api/3.0/permissions
all_permissions()

Implementation Notes

Get all supported permissions.

Response Class

  array

Parameters

  None

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Get Permission Set

GET/api/3.0/permission_sets/{permission_set_id}
permission_set(permission_set_id, fields)

Implementation Notes

Get information about the permission set with a specific id.

Response Class

PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
permission_set_id true Id of permission set integer int64
fields false Requested fields. string string

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Delete Permission Set

DELETE/api/3.0/permission_sets/{permission_set_id}
delete_permission_set(permission_set_id)

Implementation Notes

Delete the permission set with a specific id.

Response Class

  None

Parameters

Parameter Required? Description Parameter Type Data Type
permission_set_id true Id of permission set integer int64

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
204 Successfully deleted. string

Update Permission Set

PATCH/api/3.0/permission_sets/{permission_set_id}
update_permission_set(permission_set_id, body)

Implementation Notes

Update information about the permission set with a specific id.

Response Class

PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
permission_set_id true id of permission set integer int64
body true Permission Set body
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get All Permission Sets

GET/api/3.0/permission_sets
all_permission_sets(fields)

Implementation Notes

Get information about all permission sets.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
fields false Requested fields. string string

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Create Permission Set

POST/api/3.0/permission_sets
create_permission_set(body)

Implementation Notes

Create a permission set with the specified information. Permission sets are used by Roles.

Response Class

PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
body false Permission Set body
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
409 Resource Already Exists
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get All Roles

GET/api/3.0/roles
all_roles(fields, ids)

Implementation Notes

Get information about all roles.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
fields false Requested fields. string string
ids false Optional list of ids to get specific roles. array array

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Create Role

POST/api/3.0/roles
create_role(body)

Implementation Notes

Create a role with the specified information.

Response Class

Role {
id (long, read-only): Unique Id,
name (string): Name of Role,
permission_set (PermissionSet, read-only): (Read only) Permission set,
permission_set_id (long): (Write-Only) Id of permission set,
model_set (ModelSet, read-only): (Read only) Model set,
model_set_id (long): (Write-Only) Id of model set,
url (string, read-only): Link to get this item,
users_url (string, read-only): Link to get list of users with this role,
can (object, read-only): Operations the current user is able to perform on this object
}
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
body false Role body
Role {
id (long, read-only): Unique Id,
name (string): Name of Role,
permission_set (PermissionSet, read-only): (Read only) Permission set,
permission_set_id (long): (Write-Only) Id of permission set,
model_set (ModelSet, read-only): (Read only) Model set,
model_set_id (long): (Write-Only) Id of model set,
url (string, read-only): Link to get this item,
users_url (string, read-only): Link to get list of users with this role,
can (object, read-only): Operations the current user is able to perform on this object
}
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
409 Resource Already Exists
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get Role

GET/api/3.0/roles/{role_id}
role(role_id)

Implementation Notes

Get information about the role with a specific id.

Response Class

Role {
id (long, read-only): Unique Id,
name (string): Name of Role,
permission_set (PermissionSet, read-only): (Read only) Permission set,
permission_set_id (long): (Write-Only) Id of permission set,
model_set (ModelSet, read-only): (Read only) Model set,
model_set_id (long): (Write-Only) Id of model set,
url (string, read-only): Link to get this item,
users_url (string, read-only): Link to get list of users with this role,
can (object, read-only): Operations the current user is able to perform on this object
}
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of role integer int64

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Delete Role

DELETE/api/3.0/roles/{role_id}
delete_role(role_id)

Implementation Notes

Delete the role with a specific id.

Response Class

  None

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of role integer int64

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
204 Successfully deleted. string

Update Role

PATCH/api/3.0/roles/{role_id}
update_role(role_id, body)

Implementation Notes

Update information about the role with a specific id.

Response Class

Role {
id (long, read-only): Unique Id,
name (string): Name of Role,
permission_set (PermissionSet, read-only): (Read only) Permission set,
permission_set_id (long): (Write-Only) Id of permission set,
model_set (ModelSet, read-only): (Read only) Model set,
model_set_id (long): (Write-Only) Id of model set,
url (string, read-only): Link to get this item,
users_url (string, read-only): Link to get list of users with this role,
can (object, read-only): Operations the current user is able to perform on this object
}
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of role integer int64
body true Role body
Role {
id (long, read-only): Unique Id,
name (string): Name of Role,
permission_set (PermissionSet, read-only): (Read only) Permission set,
permission_set_id (long): (Write-Only) Id of permission set,
model_set (ModelSet, read-only): (Read only) Model set,
model_set_id (long): (Write-Only) Id of model set,
url (string, read-only): Link to get this item,
users_url (string, read-only): Link to get list of users with this role,
can (object, read-only): Operations the current user is able to perform on this object
}
PermissionSet {
id (long, read-only): Unique Id,
name (string): Name of PermissionSet,
permissions (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}
ModelSet {
id (long, read-only): Unique Id,
name (string): Name of ModelSet,
models (Array[string]),
built_in (boolean, read-only),
all_access (boolean, read-only),
url (string, read-only): Link to get this item,
can (object, read-only): Operations the current user is able to perform on this object
}

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get Role Groups

GET/api/3.0/roles/{role_id}/groups
role_groups(role_id, fields)

Implementation Notes

Get information about all the groups with the role that has a specific id.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of role integer int64
fields false Requested fields. string string

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Update Role Groups

PUT/api/3.0/roles/{role_id}/groups
set_role_groups(role_id, body)

Implementation Notes

Set all groups for a role, removing all existing group associations from that role.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true Id of Role integer int64
body true Array of Group Ids body array

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}

Get Role Users

GET/api/3.0/roles/{role_id}/users
role_users(role_id, fields, direct_association_only)

Implementation Notes

Get information about all the users with the role that has a specific id.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of user integer int64
fields false Requested fields. string string
direct_association_only false Get only users associated directly with the role: exclude those only associated through groups. boolean boolean

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}

Update Role Users

PUT/api/3.0/roles/{role_id}/users
set_role_users(role_id, body)

Implementation Notes

Set all the users of the role with a specific id.

Response Class

  array

Parameters

Parameter Required? Description Parameter Type Data Type
role_id true id of role integer int64
body true array of user ids for role body array

Response Messages

HTTP Status Code Reason Response Model
400 Bad Request
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
404 Not Found
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
405 Resource Can’t Be Modified
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
422 Validation Error
ValidationError {
message (string, read-only, required): Error details,
errors (Array[ValidationErrorDetail], read-only): Error detail array,
documentation_url (string, read-only, required): Documentation link
}
ValidationErrorDetail {
field (string, read-only): Field with error,
code (string, read-only): Error code,
message (string, read-only): Error info message,
documentation_url (string, read-only, required): Documentation link
}
403 Permission Denied
Error {
message (string, read-only, required): Error details,
documentation_url (string, read-only, required): Documentation link
}
Top