Create a third-party room

POST /api/2.0/files/rooms/thirdparty/{id}

Request

Creates a room in the "Rooms" section stored in a third-party storage.

Authorization

An API key is a token that you provide when making API calls. Include the token in a cookie parameter called asc_auth_key.

Example: asc_auth_key=864FE52C-1C1C-469F-9308-51DAFEFE7436.

Headers

Acceptenum of string

Can be one of: application/json, text/json, text/plain.

Content-Typeenum of string

Can be one of: application/json, application/*+json, text/json.

Path

idstringrequired

ID of the folder in the third-party storage in which the contents of the room will be stored

Body

Parameters for creating a room

createAsNewFolderboolean

Create as new folder

titlestring

Room name

roomTypeone of
.enum of string

[FillingFormsRoom - Form filling room, EditingRoom - Collaboration room, CustomRoom - Custom room, PublicRoom - Public room, VirtualDataRoom - Virtual data room]

Can be one of: FillingFormsRoom, EditingRoom, CustomRoom, PublicRoom, VirtualDataRoom.

.enum of integer

[1 - Form filling room, 2 - Collaboration room, 5 - Custom room, 6 - Public room, 8 - Virtual data room]

Can be one of: 1, 2, 5, 6, 8.

privateboolean

Private

indexingboolean

Indexing

denyDownloadboolean

Deny download

colorstring

Color

coverstring

Cover

tagsarray of string

Tags

logoobject

Logo request parameters

tmpFilestring

The path to the temporary image file

xintegerformat: int32

The X coordinate of the rectangle starting point

yintegerformat: int32

The Y coordinate of the rectangle starting point

widthintegerformat: int32

The rectangle width

heightintegerformat: int32

The rectangle height

Examples

POST /api/2.0/files/rooms/thirdparty/5706 HTTP/1.1
Accept: application/json
Content-Length: 329
Content-Type: application/json
Host: example.com

{
  "createAsNewFolder": true,
  "title": "boliviano_boliviano_system",
  "private": true,
  "indexing": true,
  "denyDownload": true,
  "color": "some text",
  "cover": "some text",
  "tags": [
    "some text"
  ],
  "logo": {
    "tmpFile": "some text",
    "x": 1234,
    "y": 1234,
    "width": 1234,
    "height": 1234
  }
}
curl --request POST \
  --url https://example.com/api/2.0/files/rooms/thirdparty/5706 \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "createAsNewFolder": true,
  "title": "boliviano_boliviano_system",
  "private": true,
  "indexing": true,
  "denyDownload": true,
  "color": "some text",
  "cover": "some text",
  "tags": [
    "some text"
  ],
  "logo": {
    "tmpFile": "some text",
    "x": 1234,
    "y": 1234,
    "width": 1234,
    "height": 1234
  }
}'

Responses

200

Room information

titlestring

Title

accessone of
.enum of string

[None - None, ReadWrite - Read and write, Read - Read, Restrict - Restrict, Varies - Varies, Review - Review, Comment - Comment, FillForms - Fill forms, CustomFilter - Custom filter, RoomManager - Room manager, Editing - Editing, ContentCreator - Content creator]

Can be one of: None, ReadWrite, Read, Restrict, Varies, Review, Comment, FillForms, CustomFilter, RoomManager, Editing, ContentCreator.

.enum of integer

[0 - None, 1 - Read and write, 2 - Read, 3 - Restrict, 4 - Varies, 5 - Review, 6 - Comment, 7 - Fill forms, 8 - Custom filter, 9 - Room manager, 10 - Editing, 11 - Content creator]

Can be one of: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11.

sharedboolean

Specifies if the file is shared or not

createdobject
utcTimestringformat: date-time

UtcTime

timeZoneOffsetstringformat: date-span

TimeZoneOffset

createdByobject
idstringformat: uuid

ID

displayNamestring

Display name

titlestring

Title

avatarstring

Avatar

avatarOriginalstring

Original size avatar

avatarMaxstring

Maximum size avatar

avatarMediumstring

Medium size avatar

avatarSmallstring

Small avatar

profileUrlstring

Profile URL

hasAvatarboolean

Specifies if the user has an avatar or not

isAnonimboolean

Specifies if the user is an anonim or not

updatedobject
utcTimestringformat: date-time

UtcTime

timeZoneOffsetstringformat: date-span

TimeZoneOffset

autoDeleteobject
utcTimestringformat: date-time

UtcTime

timeZoneOffsetstringformat: date-span

TimeZoneOffset

rootFolderTypeone of
.enum of string

[DEFAULT - Default, COMMON - Coomon, BUNCH - Bunch, TRASH - Trash, USER - User, SHARE - Share, Projects - Projects, Favorites - Favourites, Recent - Recent, Templates - Templates, Privacy - Privacy, VirtualRooms - Virtual rooms, FillingFormsRoom - Filling forms room, EditingRoom - Editing room, CustomRoom - Custom room, Archive - Archive, ThirdpartyBackup - Thirdparty backup, PublicRoom - Public room, ReadyFormFolder - Ready form folder, InProcessFormFolder - In process form folder, FormFillingFolderDone - Form filling folder done, FormFillingFolderInProgress - Form filling folder in progress, VirtualDataRoom - Virtual Data Room]

Can be one of: DEFAULT, COMMON, BUNCH, TRASH, USER, SHARE, Projects, Favorites, Recent, Templates, Privacy, VirtualRooms, FillingFormsRoom, EditingRoom, CustomRoom, Archive, ThirdpartyBackup, PublicRoom, ReadyFormFolder, InProcessFormFolder, FormFillingFolderDone, FormFillingFolderInProgress, VirtualDataRoom.

.enum of integer

[0 - Default, 1 - Coomon, 2 - Bunch, 3 - Trash, 5 - User, 6 - Share, 8 - Projects, 10 - Favourites, 11 - Recent, 12 - Templates, 13 - Privacy, 14 - Virtual rooms, 15 - Filling forms room, 16 - Editing room, 19 - Custom room, 20 - Archive, 21 - Thirdparty backup, 22 - Public room, 25 - Ready form folder, 26 - In process form folder, 27 - Form filling folder done, 28 - Form filling folder in progress, 29 - Virtual Data Room]

Can be one of: 0, 1, 2, 3, 5, 6, 8, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 25, 26, 27, 28, 29.

parentRoomTypeone of
.enum of string

[DEFAULT - Default, COMMON - Coomon, BUNCH - Bunch, TRASH - Trash, USER - User, SHARE - Share, Projects - Projects, Favorites - Favourites, Recent - Recent, Templates - Templates, Privacy - Privacy, VirtualRooms - Virtual rooms, FillingFormsRoom - Filling forms room, EditingRoom - Editing room, CustomRoom - Custom room, Archive - Archive, ThirdpartyBackup - Thirdparty backup, PublicRoom - Public room, ReadyFormFolder - Ready form folder, InProcessFormFolder - In process form folder, FormFillingFolderDone - Form filling folder done, FormFillingFolderInProgress - Form filling folder in progress, VirtualDataRoom - Virtual Data Room]

Can be one of: DEFAULT, COMMON, BUNCH, TRASH, USER, SHARE, Projects, Favorites, Recent, Templates, Privacy, VirtualRooms, FillingFormsRoom, EditingRoom, CustomRoom, Archive, ThirdpartyBackup, PublicRoom, ReadyFormFolder, InProcessFormFolder, FormFillingFolderDone, FormFillingFolderInProgress, VirtualDataRoom.

.enum of integer

[0 - Default, 1 - Coomon, 2 - Bunch, 3 - Trash, 5 - User, 6 - Share, 8 - Projects, 10 - Favourites, 11 - Recent, 12 - Templates, 13 - Privacy, 14 - Virtual rooms, 15 - Filling forms room, 16 - Editing room, 19 - Custom room, 20 - Archive, 21 - Thirdparty backup, 22 - Public room, 25 - Ready form folder, 26 - In process form folder, 27 - Form filling folder done, 28 - Form filling folder in progress, 29 - Virtual Data Room]

Can be one of: 0, 1, 2, 3, 5, 6, 8, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 25, 26, 27, 28, 29.

updatedByobject
idstringformat: uuid

ID

displayNamestring

Display name

titlestring

Title

avatarstring

Avatar

avatarOriginalstring

Original size avatar

avatarMaxstring

Maximum size avatar

avatarMediumstring

Medium size avatar

avatarSmallstring

Small avatar

profileUrlstring

Profile URL

hasAvatarboolean

Specifies if the user has an avatar or not

isAnonimboolean

Specifies if the user is an anonim or not

providerItemboolean

Provider is specified or not

providerKeystring

Provider key

providerIdintegerformat: int32

Provider ID

orderstring

Order

idstring

Id

rootFolderIdstring

Root folder id

originIdstring

Origin id

originRoomIdstring

Origin room id

originTitlestring

Origin title

originRoomTitlestring

Origin room title

canShareboolean

Can share

securityobject

Security

Readboolean
Commentboolean
FillFormsboolean
Reviewboolean
Createboolean
Editboolean
Deleteboolean
CustomFilterboolean
EditRoomboolean
Renameboolean
ReadHistoryboolean
Lockboolean
EditHistoryboolean
CopyToboolean
Copyboolean
MoveToboolean
Moveboolean
Pinboolean
Muteboolean
EditAccessboolean
Duplicateboolean
SubmitToFormGalleryboolean
Downloadboolean
Convertboolean
CopySharedLinkboolean
ReadLinksboolean
Reconnectboolean
CreateRoomFromboolean
CopyLinkboolean
Embedboolean
ChangeOwnerboolean
IndexExportboolean
requestTokenstring
parentIdstring

Parent folder ID

filesCountintegerformat: int32

Number of files

foldersCountintegerformat: int32

Number of folders

isShareableboolean

Specifies if a folder is shareable or not

isFavoriteboolean

Specifies if a folder is favorite or not

newintegerformat: int32

Number for a new folder

muteboolean

Specifies if a folder is muted or not

tagsarray of string

List of tags

logoobject
originalstring

Original

largestring

Large

mediumstring

Medium

smallstring

Small

colorstring

Color

coverobject
idstring
datastring
pinnedboolean

Specifies if a folder is pinned or not

roomTypeone of
.enum of string

[FillingFormsRoom - Form filling room, EditingRoom - Collaboration room, CustomRoom - Custom room, PublicRoom - Public room, VirtualDataRoom - Virtual data room]

Can be one of: FillingFormsRoom, EditingRoom, CustomRoom, PublicRoom, VirtualDataRoom.

.enum of integer

[1 - Form filling room, 2 - Collaboration room, 5 - Custom room, 6 - Public room, 8 - Virtual data room]

Can be one of: 1, 2, 5, 6, 8.

privateboolean

Specifies if a folder is private or not

indexingboolean

Indexing

denyDownloadboolean

Deny download

lifetimeobject
deletePermanentlyboolean

Specifies action

periodenum of integerformat: int32

Can be one of: 0, 1, 2.

valueintegerformat: int32

Specifies time period value

enabledboolean

Enabled

watermarkobject
additionsone of
.enum of string

[UserName - User name, UserEmail - User email, UserIpAdress - User ip adress, CurrentDate - Current date, RoomName - Room name]

Can be one of: UserName, UserEmail, UserIpAdress, CurrentDate, RoomName.

.enum of integer

[1 - User name, 2 - User email, 4 - User ip adress, 8 - Current date, 16 - Room name]

Can be one of: 1, 2, 4, 8, 16.

textstring

Watermark Text

rotateintegerformat: int32

Watermark text and image rotate

imageScaleintegerformat: int32

Watermark image scale

imageUrlstring

Watermark image url

imageHeightnumberformat: double

Watermark image height

imageWidthnumberformat: double

Watermark image width

typeone of
.enum of string

[DEFAULT - Default, COMMON - Coomon, BUNCH - Bunch, TRASH - Trash, USER - User, SHARE - Share, Projects - Projects, Favorites - Favourites, Recent - Recent, Templates - Templates, Privacy - Privacy, VirtualRooms - Virtual rooms, FillingFormsRoom - Filling forms room, EditingRoom - Editing room, CustomRoom - Custom room, Archive - Archive, ThirdpartyBackup - Thirdparty backup, PublicRoom - Public room, ReadyFormFolder - Ready form folder, InProcessFormFolder - In process form folder, FormFillingFolderDone - Form filling folder done, FormFillingFolderInProgress - Form filling folder in progress, VirtualDataRoom - Virtual Data Room]

Can be one of: DEFAULT, COMMON, BUNCH, TRASH, USER, SHARE, Projects, Favorites, Recent, Templates, Privacy, VirtualRooms, FillingFormsRoom, EditingRoom, CustomRoom, Archive, ThirdpartyBackup, PublicRoom, ReadyFormFolder, InProcessFormFolder, FormFillingFolderDone, FormFillingFolderInProgress, VirtualDataRoom.

.enum of integer

[0 - Default, 1 - Coomon, 2 - Bunch, 3 - Trash, 5 - User, 6 - Share, 8 - Projects, 10 - Favourites, 11 - Recent, 12 - Templates, 13 - Privacy, 14 - Virtual rooms, 15 - Filling forms room, 16 - Editing room, 19 - Custom room, 20 - Archive, 21 - Thirdparty backup, 22 - Public room, 25 - Ready form folder, 26 - In process form folder, 27 - Form filling folder done, 28 - Form filling folder in progress, 29 - Virtual Data Room]

Can be one of: 0, 1, 2, 3, 5, 6, 8, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 25, 26, 27, 28, 29.

inRoomboolean

InRoom

quotaLimitintegerformat: int64

Quota

isCustomQuotaboolean

Specifies if the room has a custom quota or not

usedSpaceintegerformat: int64

Counter

externalboolean

Specifies if the link external

passwordProtectedboolean

Specifies if the password protected

expiredboolean

Expired

fileEntryTypeenum of integerformat: int32

Can be one of: 1, 2.

401

Unauthorized

Get Help

  • If you have any questions about ONLYOFFICE DocSpace, try the FAQ section first.
  • You can request a feature or report a bug by posting an issue on GitHub.
  • You can also ask our developers on ONLYOFFICE forum (registration required).