HTTP - Management

Role

Created by Contensis product team, last modified by zengenti on 21 Jan 2021

Role definitions in the Management API contain permissions associated with content types and entries, and other resource types (e.g. webhook subscriptions, proxies, event streams), with users and groups assigned to those permissions.

Properties

Name	Data type	Data format	Description
name	object	localized value	The name of the role.
description	object	localized value	The description of the role.
enabled	boolean		If true then this role is enabled, otherwise false.
permissions	object[...]		Permissions associated with content types and entries.
permissions.entries	object[...]		An array of permissions for entries
permissions.entries.languages	string[...]		One or more languages to give permissions to. * denotes all languages.
permissions.entries.actions	string[...]		One or more actions to give permission to. denotes all actions. {workflowStateName}. denotes all permissions applicable to the given workflow state.
assignments	object[...]		An array of assignments for entries
assignments.users	string[...]		Zero or more user names
assignments.groups	string[...]		Zero or more group names
assignments.apiKeys	string[...]		Zero or more API key names

Example

JSON

{
    "id": "34f503ca-fd44-4d47-b86a-c9d94c4d5d54",
    "projectId": "website",
    "name": {
        "en-GB": "Movie Editors"
    },
    "description": {
        "en-GB": "Movie editors can edit movie entries, but not submit or approve them"
    },
    "enabled": true,
    "permissions": {
        "entries": [
            {
                "id": "movie",
                "languages": [
                    "en-GB"
                ],
                "actions": [
                    "sys.update",
                    "draft.*",
                    "awaitingApproval.revoke"
                ]
            }
        ],
        "assets": [{
                "id": "*",
                "languages": ["*"],
                "actions": ["contensisEntryBasic.*"]
            }
        ],
        "webhookSubscriptions": {
            "actions": ["create", "view"]
        },
        "proxies": {
            "actions": ["create", "update", "publish"]
        },
        "eventStreams": {
            "actions": ["connect", "useCustomTemplates"]
        }
},
    "assignments": {
        "users": [
            "f.haygood"
        ],
        "groups": [
            "Movie Editors"
        ],
        "apiKeys": [
            "Movie Import"
        ]
    }
}