Show examples in:
    Update a role

    Parameters

    name  Optional  string  Example: "Editor"

    The name of the role

    can_edit_favicon  Optional  boolean  Example: true

    Can edit favicon, global SEO settings and no-index policy

    can_edit_site  Optional  boolean  Example: true

    Can change project global properties

    can_edit_schema  Optional  boolean  Example: true

    Can create/edit models and plugins

    can_manage_menu  Optional  boolean  Example: true

    Can customize content navigation bar

    can_edit_environment  Optional  boolean  Example: true

    Can change locales, timezone and UI theme

    can_promote_environments  Optional  boolean  Example: true

    Can promote environments to primary and manage maintenance mode

    environments_access  Optional  enum  Example: "primary_only"

    Specifies the environments the user can access

    can_manage_users  Optional  boolean  Example: true

    Can create/edit roles and invite/remove collaborators

    can_manage_shared_filters  Optional  boolean  Example: true

    Can create/edit shared filters (both for models and the media area)

    can_manage_build_triggers  Optional  boolean  Example: true

    Can create/edit Build triggers

    can_manage_webhooks  Optional  boolean  Example: true

    Can create/edit webhooks

    can_manage_environments  Optional  boolean  Example: true

    Can create/delete sandbox environments and promote them to primary environment

    can_manage_sso  Optional  boolean  Example: true

    Can manage Single Sign-On settings

    can_access_audit_log  Optional  boolean  Example: true

    Can access Audit Log

    can_manage_workflows  Optional  boolean  Example: true

    Can create/edit workflows

    can_manage_access_tokens  Optional  boolean  Example: true

    Can manage API tokens

    can_perform_site_search  Optional  boolean  Example: true

    Can perform Site Search API calls

    can_access_build_events_log  Optional  boolean  Example: true

    Can access the build events log

    positive_item_type_permissions  Optional  Array<object>

    Allowed actions on a model (or all) for a role

    negative_item_type_permissions  Optional  Array<object>

    Prohibited actions on a model (or all) for a role

    positive_upload_permissions  Optional  Array<object>

    Allowed actions on a model (or all) for a role

    negative_upload_permissions  Optional  Array<object>

    Prohibited actions on a model (or all) for a role

    positive_build_trigger_permissions  Optional  Array<object>

    Allowed build triggers for a role

    negative_build_trigger_permissions  Optional  Array<object>

    Prohibited build triggers for a role

    meta.final_permissions  Optional  object

    The final set of permissions considering also inherited roles

    inherits_permissions_from  Optional  Array of { type: "role", id: role.id }

    The roles from which this role inherits permissions

    Returns

    Returns a role resource object.

    Examples

    Example code:
    import { buildClient } from '@datocms/cma-client-node';
    async function run() {
    const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
    const roleId = '34';
    const role = await client.roles.update(roleId, {
    name: 'Editor',
    can_edit_favicon: true,
    can_edit_site: true,
    can_edit_schema: true,
    can_manage_menu: true,
    can_edit_environment: true,
    can_promote_environments: true,
    environments_access: 'primary_only',
    can_manage_users: true,
    can_manage_shared_filters: true,
    can_manage_build_triggers: true,
    can_manage_webhooks: true,
    can_manage_environments: true,
    can_manage_sso: true,
    can_access_audit_log: true,
    can_manage_workflows: true,
    can_manage_access_tokens: true,
    can_perform_site_search: true,
    can_access_build_events_log: true,
    positive_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    negative_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    meta: {
    final_permissions: {
    can_edit_favicon: true,
    can_edit_site: true,
    can_edit_schema: true,
    can_manage_menu: true,
    can_edit_environment: true,
    can_promote_environments: true,
    environments_access: 'primary_only',
    can_manage_users: true,
    can_manage_shared_filters: true,
    can_manage_build_triggers: true,
    can_manage_webhooks: true,
    can_manage_environments: true,
    can_manage_sso: true,
    can_access_audit_log: true,
    can_manage_workflows: true,
    can_manage_access_tokens: true,
    can_perform_site_search: true,
    can_access_build_events_log: true,
    positive_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    negative_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ]
    }
    },
    inherits_permissions_from: [
    {
    type: 'role',
    id: '34'
    }
    ]
    });
    console.log(role);
    }
    run();
    Returned output:
    {
    id: '34',
    name: 'Editor',
    can_edit_favicon: true,
    can_edit_site: true,
    can_edit_schema: true,
    can_manage_menu: true,
    can_edit_environment: true,
    can_promote_environments: true,
    environments_access: 'primary_only',
    can_manage_users: true,
    can_manage_shared_filters: true,
    can_manage_build_triggers: true,
    can_manage_webhooks: true,
    can_manage_environments: true,
    can_manage_sso: true,
    can_access_audit_log: true,
    can_manage_workflows: true,
    can_manage_access_tokens: true,
    can_perform_site_search: true,
    can_access_build_events_log: true,
    positive_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    negative_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    meta: {
    final_permissions: {
    can_edit_favicon: true,
    can_edit_site: true,
    can_edit_schema: true,
    can_manage_menu: true,
    can_edit_environment: true,
    can_promote_environments: true,
    environments_access: 'primary_only',
    can_manage_users: true,
    can_manage_shared_filters: true,
    can_manage_build_triggers: true,
    can_manage_webhooks: true,
    can_manage_environments: true,
    can_manage_sso: true,
    can_access_audit_log: true,
    can_manage_workflows: true,
    can_manage_access_tokens: true,
    can_perform_site_search: true,
    can_access_build_events_log: true,
    positive_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_item_type_permissions: [
    {
    item_type: 'DxMaW10UQiCmZcuuA-IkkA',
    workflow: 'uJzC2b6YQg-DW2A5edpQYQ',
    on_stage: '',
    to_stage: '',
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    negative_upload_permissions: [
    {
    environment: 'main',
    action: 'all',
    on_creator: 'self',
    localization_scope: 'all',
    locale: 'en'
    }
    ],
    positive_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ],
    negative_build_trigger_permissions: [
    {
    build_trigger: '1822'
    }
    ]
    }
    },
    inherits_permissions_from: [
    {
    type: 'role',
    id: '34'
    }
    ]
    }