[comment]: # ({75c59923-c165c37a})
# Screen object

The following objects are directly related to the `screen` API.

[comment]: # ({/75c59923-c165c37a})

[comment]: # ({a7b4cff2-2e9a0f45})
### Screen

The screen object has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|screenid|string|*(readonly)* ID of the screen.|
|**name**<br>(required)|string|Name of the screen.|
|hsize|integer|Width of the screen.<br><br>Default: 1|
|vsize|integer|Height of the screen.<br><br>Default: 1|
|userid|string|Screen owner user ID.|
|private|integer|Type of screen sharing.<br><br>Possible values:<br>0 - public screen;<br>1 - *(default)* private screen.|

[comment]: # ({/a7b4cff2-2e9a0f45})

[comment]: # ({3c27a894-2ee0564e})
### Screen user

List of screen permissions based on users. It has the following
properties:

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|screenuserid|string|*(readonly)* ID of the screen user.|
|**userid**<br>(required)|string|User ID.|
|**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|

[comment]: # ({/3c27a894-2ee0564e})

[comment]: # ({8f45ca08-ab2af880})
### Screen user group

List of screen permissions based on user groups. It has the following
properties:

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|screenusrgrpid|string|*(readonly)* ID of the screen user group.|
|**usrgrpid**<br>(required)|string|User group ID.|
|**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|

[comment]: # ({/8f45ca08-ab2af880})