SpacePermissionRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/SpacePermissionRequest",
  "title": "SpacePermissionRequest",
  "required": [
    "subject",
    "operation"
  ],
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "subject": {
      "$ref": "#/components/schemas/PermissionSubject"
    },
    "operation": {
      "required": [
        "key",
        "target"
      ],
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "enum": [
            "administer",
            "archive",
            "copy",
            "create",
            "delete",
            "export",
            "move",
            "purge",
            "purge_version",
            "read",
            "restore",
            "restrict_content",
            "update",
            "use"
          ]
        },
        "target": {
          "type": "string",
          "description": "The space or content type that the operation applies to.",
          "enum": [
            "page",
            "blogpost",
            "comment",
            "attachment",
            "space"
          ]
        }
      }
    },
    "_links": {
      "$ref": "#/components/schemas/GenericLinks"
    }
  },
  "description": "This object represents the request for the single space permission. Permissions consist of\none operation object with an accompanying subjects object.\n\nThe following combinations of `operation.key` and `operation.target` values are\nvalid for the `operation` object:\n``` bash\n'create': 'page', 'blogpost', 'comment', 'attachment'\n'read': 'space'\n'delete': 'page', 'blogpost', 'comment', 'attachment', 'space'\n'export': 'space'\n'administer': 'space'\n'archive': 'page'\n'restrict_content': 'space'\n```\n\nFor example, to enable Delete Own permission, set the `operation` object to the following:\n```\n\"operation\": {\n    \"key\": \"delete\",\n    \"target\": \"space\"\n}\n```\nTo enable Add/Delete Restrictions permissions, set the `operation` object to the following:\n```\n\"operation\": {\n    \"key\": \"restrict_content\",\n    \"target\": \"space\"\n}\n```"
}